Introduction

K-9 targets Java 1.5. Release builds are currently made on Mac OS X against Apple's javac. Java 1.6isms are not acceptable in the K-9 code.

K-9 uses ant for its build process.

As of r670, the build is using SDK 1.5 and targeting devices with Android 1.5 (Cupcake).

Building with ant

To build

• Create a file called 'local.properties' at the root of the source tree with the following entry

sdk-location=/path/to/android_sdk

• # ant debug

To install on your simulator or local device

# adb install -r bin/K9-debug.apk

To build and sign the project for upload to the marketplace

1. Edit AndroidManifest.xml to increment the versionCode
2. Edit res/values/strings.xml to increment app_version
3. # jarpass=yoursecret ANDROID_SDK=/path/to/android_sdk ant release
4. Check in your new version number and regenerated R.java (if it's changed)
5. Test on actual device hardware
6. Upload to the market

Building with Eclipse

See issue 755 for updated info

You'll need Eclipse with the Android Development Tools plugin installed. Follow the full directions found here:

http://code.google.com/android/intro/installing.html

Once you have Eclipse installed, create a new Android project in your workspace. Select the "Create project from existing source" and browse to the location of the source and click Finish. You should see the project in the project explorer window.

To install on your simulator or local device

Go to Run->Run Configurations Click Android Application then click the "new" icon (sheet with plus sign) Change the name to your liking, then click the brows button and select the K9 project. Click OK.

On subsequent runs, you can click Run->Run History and then click the name of your Run Configuration.