The Android source repositories are quite chaotic.  They often include a mix
of things under arbitrary umbrellas.  For example, there are parts of this
particular repository that will only ever be built when building the complete
Android OS (aka "target"), other parts that are only built as part of the SDK
to support building Android apps (aka "host"), and other parts that are used
both in the SDK and the Android OS. Most of the source code in this particular
repostory will never be built or included on Debian because it is only used in
the Android OS.

It is possible to see which sections will be built for what by looking at the
Android.mk files.  The parts that are meant for the "host" system, in this
case Debian, will have lines like this in it:

  * include $(BUILD_HOST_EXECUTABLE)
  * include $(BUILD_HOST_JAVA_LIBRARY)
  * include $(BUILD_HOST_SHARED_LIBRARY)
  * include $(BUILD_HOST_STATIC_LIBRARY)

The build targets that are only for Android OS builds instead have this:

  * include $(BUILD_EXECUTABLE)
  * include $(BUILD_JAVA_LIBRARY)
  * include $(BUILD_SHARED_LIBRARY)
  * include $(BUILD_STATIC_LIBRARY)

A given chunk of code that is built both for "host" will have both of these
lines included in the Android.mk file.


Structure of the package's git repository
-----------------------------------------

The source code has been excerpted form the git repository

  * https://android.googlesource.com/platform/development
  * https://android.googlesource.com/platform/external/junit
  * https://android.googlesource.com/platform/frameworks/base
  * https://android.googlesource.com/platform/frameworks/opt/net/voip
  * https://android.googlesource.com/platform/frameworks/opt/telephony
  * https://android.googlesource.com/platform/libcore

We make these repositories into one single source package because the binary
packages built here need source code from all of them.

Files under the debian/android/ directory
-----------------------------------------

These files were created based on the information in the files listed below them.

 * build.prop:
   * From src:android-platform-tools-base
     base/sdklib/src/main/java/com/android/sdklib/repository/local/LocalPlatformPkgInfo.java
   * From src:android-platform-build
     tools/buildinfo.sh
     core/version_defaults.mk

 * source.properties:
   * From src:android-platform-development
     sdk/platform_source.prop_template
   * From src:android-platform-build
     core/version_defaults.mk

 * sdk.properties:
   * From src:android-platform-development
     sdk/sdk.properties

debian/shrinkedAndroid.proguard.flags
-------------------------------------

Copied from [1]. This file does not seem to change any time soon.

Other unmentioned files are copied from the upstream Google repository.

[1]: https://android.googlesource.com/platform/dalvik/+/master/dx/shrinkedAndroid.proguard.flags

 -- Hans-Christoph Steiner <hans@eds.org>  Thu, 18 Sep 2014 16:37:50 -0400
 -- Kai-Chung Yan <seamlikok@gmail.com>  Fri, 07 Oct 2016 19:11:58 +0800
 -- Chirayu Desai <chirayudesai1@gmail.com>  Fri, 05 Aug 2016 15:43:47 +0530