1<p>This sample demonstrates how an application can make use of shared code and 2resources stored in an Android library project.</p> 3 4<p>In this case, the TicTacToeMain application project includes a reference to 5the TicTacToeLib library project. When you build the TicTacToeMain application, 6the build tools look for the library project and compile it's code and resources 7as part of the main application's <code>.apk</code> file. The main application 8is designed with a launcher activity called <code>MainActivity</code>, shown at 9left, below. When the user presses a button in the View, 10<code>MainActivity</code> starts a second activity, <code>GameActivity</code>, 11which is declared in the library project. </p> 12 13<ul> 14<li>The main application's <a 15href="AndroidManifest.html">AndroidManifest.xml</a> file contains declarations 16of both <code>MainActivity</code>, which is implemented locally in main project, 17and <code>GameActivity</code>, which is implemented in the library project. 18Currently, an application must declare in its manifest any components or 19resources that it is using from a library project.</li> 20<li><a 21href="src/com/example/android/tictactoe/MainActivity.html">MainActivity.java</a> 22shows how a class in the main application imports and uses 23classes from the library project. The Activity sets listeners on the buttons in 24the main View and, when one of them is clicked, creates an explicit Intent 25targeted at the <code>GameActivity</code> component declared in the TicTacToeLib 26library project. </li> 27</ul> 28 29<p>The TicTacToeLib library project includes a single Activity, 30<code>GameActivity</code>, that handles most of the application lifecycle.</p> 31 32<ul> 33<li>The library project includes an <a 34href="../TicTacToeLib/AndroidManifest.html">AndroidManifest.xml</a> file that 35declares <code>GameActivity</code>.</li> 36<li><a 37href="../TicTacToeLib/src/com/example/android/tictactoe/library/GameActivity.html">GameActivity.java</a> 38handles most of the application lifecycle and manages general game play.</li> 39<li><a 40href="../TicTacToeLib/src/com/example/android/tictactoe/library/GameView.html">GameView.java</a> 41renders the UI of the game and manages interaction events during game play.</li> 42</ul> 43 44<p>If you want to build the TicTacToeMain application, you can obtain it by 45downloading the "Samples for SDK API 8" component (or higher version) into your 46SDK, using the <em>Android SDK and AVD Manager</em>. Note that the application 47project depends on code and resources found in the TicTacToeLib library project 48— in order to build TicTacToeMain, you need to add both projects to your 49development environment. </p> 50 51<p>To build an application that uses a library project, you also need to update 52to the latest version of the SDK tools (r6 or higher) and Android platforms, as 53well as the latest version of ADT (0.9.7 or higher), if you are developing in 54Eclipse. </p> 55 56<p>For information about how to set up Android library projects, refer to 57<a href="../../../guide/developing/eclipse-adt.html#libraryProject">Developing 58in Eclipse with ADT</a> or <a 59href="../../../guide/developing/other-ide.html#libraryProject">Developing in 60Other IDEs</a>, depending on your environment.</p> 61 62<img alt="Screenshot of the main application" src="../images/TicTacToeMain.png" /> 63<img alt="Screenshot of an Activity declared in a library project" src="../images/TicTacToeLib.png" /> 64
