Android example source code file (README.txt)

This example Android source code file (README.txt) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Android by Example" ^TM.

Java - Android tags/keywords

adt, android, ant, apk, build, eclipse, it, sample, sdk, summary, tictactoelib, tictactoemain, to, when

The README.txt Android example source code

Sample: TicTacToeLib and TicTacToeMain.

--------
Summary:
--------

These two projects work together. They demonstrate how to use the ability to
split an APK into multiple projects.

Build is supported both via Ant (command-line tools) or via ADT (the Android
plugin for Eclipse).

--------
Details:
--------

TicTacToeMain is the main project. It defines a main activity that is first
displayed to the user. When one of the start buttons is selected, an
activity defined in TicTacToeLib is started.

To define that TicTacToeMain uses TicTacToeLib as a "project library", the
file TicTacToeMain/default.properties contains the special line:
  android.library.reference.1=../TicTacToeLib/


TicTacToeLib is the "project library". It can contain both source code (.java)
and Android resources (anything under /res) that will be merged in the final
APK. To define this is a library, the file TicTacToeLib/default.project
contains the special line:
  android.library=true


One important thing to realize is that the library is not a separately-compiled
JAR file: the source and resources from the library are _actually_ merged in
the main project and the result is used to generate the APK. This means that
the main project can either use or redefine behavior from the libraries.


To use the main vs library project:
- In ADT, just open import both projects and launch the main project.
- In Ant, use 'android update project' to create the build files and set the SDK location,
  and then run 'ant debug' on the main project.


For more details on the purpose of this feature, its limitations and detailed usage,
please read the SDK guide at
  http://developer.android.com/guide/developing/eclipse-adt.html