Builing OI Applications

More video tutorials available at Screencasts.

• Builing OI Applications
• Instructions for running applications
• Using Eclipse
• How to build...
• OI File Manager
• OI Shopping List
• OI Safe
• Using Ant
• In case of problems

Instructions for running OpenIntents applications

Building the applications require:

• The latest Android SDK
• Eclipse IDE for Java developers
• Follow this guide to installing the Android SDK

Get the latest source code using SVN:

• Get Subversion.
• Windows users can use TortoiseSVN
• A plugin for Eclipse is also available at Subclipse
• Checkout OpenIntents code

Using Eclipse

Most projects depend on the OI Distribution Library, which is located in trunk/distribution/DistributionLibrary. Generally you should:

• import the application and trunk/distribution/DistributionLibrary (and if applicable further required library projects)
• open all projects
• launch the application.

How to build...

OI File Manager

• Import OI File Manager
• In Eclipse, select menu > File > Import
• Select General / Existing Projects into Workspace -> press "Next"
• "Select root directory" -> Browse -> trunk/filemanager/FileManager -> press "OK"
• "OI File Manager" checked -> press "Finish"
• IMPORTANT: You also have to import OI Distribution Library!
• File -> Import
• Select General / Existing Projects into Workspace -> press "Next"
• "Select root directory" -> Browse -> trunk/distribution/DistributionLibrary -> press "OK"
• "OI Distribution Library" checked -> press "Finish"
• Build the applications
• In Eclipse, select menu > Project > Build all
• In the Package Explorer select "OI File Manager"
• menu > Run > Run
• "Select a way to run 'OI File Manager'" -> select "Android Application" -> press "OK"
• If necessary, create an AVD

In case of problems:

• In tab "Problems" you see: "The project cannot be built until build path errors are resolved"
• Try:
• menu > Project > Clean
• "Clean all projects" > "OK"
• Force the Android pre-compiler to rebuild the application by the following "trick":
• Open OI File Manager / Android Manifest
• Go to line 17, and change "<manifest" to "<manifestXXX"
• menu > File > Save.
• change back to "<manifest"
• menu > File > Save.
• menu > Run > Run.

OI Shopping List

See the instructions above for OI File Manager, but use trunk/shoppinglist/ShoppingList instead.

IMPORTANT You need not only the Shopping List, but also 2 libraries:

• OI Shopping: trunk/shoppinglist/ShoppingList
• OI Distribution Library: trunk/distribution/DistributionLibrary
• OI Shopping Library: trunk/shoppinglist/ShoppingListLibrary

OI Safe

Follow essentially the instructions for OI File Manager.

If the application does not compile, you may need to invoke "aidl" manually:

cd safe/Safe/src/org/openintents/safe/service
aidl ServiceDispatch.aidl

This creates ServiceDispatch.java.

Using Ant

If you use Eclipse, most probably you don't need Ant. Building the applications outside Eclipse, or if you want to build a release version using the ant build scripts, you need at least Ant 1.8.

• Ant 1.8 (if you are using ant)

Then:

• launch build.xml
• the OI Distribution Library is included automatically.

In case of problems

• In properties, Java Build Path, add OI Dist Lib and Shopping Lib to the Projects tab manually.

• In the Order and Export tab, move those two libs to the top (just under Android), in order to avoid an error message that two APKs would be missing (One for Dist Lib and one for Shopping Lib).

• In properties, Android, remove the two libs from "Library" and re-add them.