Android Development Guidelines

This page shall collect resources for good software developement on the Android platform.

App Development

• Follow the best practices on the Android Training Website: http://developer.android.com/training/index.html
• Official design guidelines: http://developer.android.com/design/index.html
  • Official design files: http://developer.android.com/design/downloads/index.html
• Do not depend on Google libraries (e.g. maps.jar).

Maven Project Creation

Maven is mandatory for app development at 52N!

Prerequisites

• android-maven-plugin: http://code.google.com/p/maven-android-plugin/
• maven-license-plugin: http://code.google.com/p/maven-license-plugin/ (HowTo)
• External jars are to be included following https://wiki.52north.org/bin/view/Documentation/BestPracticeJarsInMaven

Step-by-step Guide

• New > Maven Project
• Select one of the following archetypes: https://github.com/akquinet/android-archetypes/wiki
• Mandatory elements in the POM file and their default values (if applicable) are listed below. The closing tags are omitted to clarify where values must be entered.

          <groupId>org.n52.android</groupId>
          <artifactId>
          <packaging>
          <version>
          <name>
          <description>
          <url>http://52north.org/android</url>
     <inceptionYear>the year</inceptionYear> (or project specific one!)
     <organization>
        <name>52&#176;North Initiative for Geospatial Open Source Software GmbH</name>
        <url>http://52north.org</url>
     </organization>
          <developers>
                  <developer>
                          <name>name here
                          <email>email@52north.org
                          <organization>${project.organization.name}
                          <organizationUrl>${project.organization.url}
                          <id>SVN/Wiki name here
                   </developer>
          </developers>
          <mailingLists><mailingList> (the appropriate community mailing list(s))
     <scm>
        <connection>scm:svn:https://svn.52north.org/svn/projects/android/... (add the correct url!)
     </scm>
     <licenses>
        <license>
           <name>Apache 2</name>
           <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
           <distribution>repo</distribution>
           <comments>A business-friendly OSS license</comments>
        </license>
     </licenses>
  

Software License

The license for all Android-related projects is Apache 2.0, see https://wiki.52north.org/bin/view/Contributor/ApacheLicenseHowto, and all libraries you depend on should be compatible.

Metadata

• Topic created by: DanielNuest
• Topic created on: 2012-01-31