README.txt
1Sample: TicTacToeLib and TicTacToeMain.
2
3--------
4Summary:
5--------
6
7These two projects work together. They demonstrate how to use the ability to
8split an APK into multiple projects.
9
10Build is supported both via Ant (command-line tools) or via ADT (the Android
11plugin for Eclipse).
12
13--------
14Details:
15--------
16
17TicTacToeMain is the main project. It defines a main activity that is first
18displayed to the user. When one of the start buttons is selected, an
19activity defined in TicTacToeLib is started.
20
21To define that TicTacToeMain uses TicTacToeLib as a "project library", the
22file TicTacToeMain/default.properties contains the special line:
23 android.library.reference.1=../TicTacToeLib/
24
25
26TicTacToeLib is the "project library". It can contain both source code (.java)
27and Android resources (anything under /res) that will be merged in the final
28APK. To define this is a library, the file TicTacToeLib/default.project
29contains the special line:
30 android.library=true
31
32
33One important thing to realize is that the library is not a separately-compiled
34JAR file: the source and resources from the library are _actually_ merged in
35the main project and the result is used to generate the APK. This means that
36the main project can either use or redefine behavior from the libraries.
37
38
39To use the main vs library project:
40- In ADT, just open import both projects and launch the main project.
41- In Ant, use 'android update project' to create the build files and set the SDK location,
42 and then run 'ant debug' on the main project.
43
44
45For more details on the purpose of this feature, its limitations and detailed usage,
46please read the SDK guide at
47 http://developer.android.com/guide/developing/eclipse-adt.html
48
49