Android.mk

   1 #
   2 # Copyright (C) 2008 The Android Open Source Project
   3 #
   4 # Licensed under the Apache License, Version 2.0 (the "License");
   5 # you may not use this file except in compliance with the License.
   6 # You may obtain a copy of the License at
   7 #
   8 #      http://www.apache.org/licenses/LICENSE-2.0
   9 #
  10 # Unless required by applicable law or agreed to in writing, software
  11 # distributed under the License is distributed on an "AS IS" BASIS,
  12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 # See the License for the specific language governing permissions and
  14 # limitations under the License.
  15 #
  16 LOCAL_PATH := $(call my-dir)
  17
  18 # We have a special case here where we build the library's resources
  19 # independently from its code, so we need to find where the resource
  20 # class source got placed in the course of building the resources.
  21 # Thus, the magic here.
  22 # Also, this module cannot depend directly on the R.java file; if it
  23 # did, the PRIVATE_* vars for R.java wouldn't be guaranteed to be correct.
  24 # Instead, it depends on the R.stamp file, which lists the corresponding
  25 # R.java file as a prerequisite.
  26 # TODO: find a more appropriate way to do this.
  27 framework_res_source_path := APPS/framework-res_intermediates/src
  28
  29 # the library
  30 # ============================================================
  31 include $(CLEAR_VARS)
  32
  33 # FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
  34 LOCAL_SRC_FILES := $(call find-other-java-files,$(FRAMEWORKS_BASE_SUBDIRS))
  35
  36 # EventLogTags files.
  37 LOCAL_SRC_FILES += \
  38        core/java/android/content/EventLogTags.logtags \
  39        core/java/android/webkit/EventLogTags.logtags \
  40        telephony/java/com/android/internal/telephony/EventLogTags.logtags \
  41
  42 # The following filters out code we are temporarily not including at all.
  43 # TODO: Move AWT and beans (and associated harmony code) back into libcore.
  44 # TODO: Maybe remove javax.microedition entirely?
  45 # TODO: Move SyncML (org.mobilecontrol.*) into its own library.
  46 LOCAL_SRC_FILES := $(filter-out \
  47                         org/mobilecontrol/% \
  48                         ,$(LOCAL_SRC_FILES))
  49
  50 # Include a different set of source files when building a debug build.
  51 # TODO: Maybe build these into a separate .jar and put it on the classpath
  52 #       in front of framework.jar.
  53 # NOTE: Do not use this as an example; this is a very special situation.
  54 #       Do not modify LOCAL_SRC_FILES based on any variable other
  55 #       than TARGET_BUILD_TYPE, otherwise builds can become inconsistent.
  56 ifeq ($(TARGET_BUILD_TYPE),debug)
  57   LOCAL_SRC_FILES += $(call find-other-java-files,core/config/debug)
  58 else
  59   LOCAL_SRC_FILES += $(call find-other-java-files,core/config/ndebug)
  60 endif
  61
  62 ## READ ME: ########################################################
  63 ##
  64 ## When updating this list of aidl files, consider if that aidl is
  65 ## part of the SDK API.  If it is, also add it to the list below that
  66 ## is preprocessed and distributed with the SDK.  This list should
  67 ## not contain any aidl files for parcelables, but the one below should
  68 ## if you intend for 3rd parties to be able to send those objects
  69 ## across process boundaries.
  70 ##
  71 ## READ ME: ########################################################
  72 LOCAL_SRC_FILES += \
  73         core/java/android/accessibilityservice/IAccessibilityServiceConnection.aidl \
  74         core/java/android/accessibilityservice/IEventListener.aidl \
  75         core/java/android/accounts/IAccountManager.aidl \
  76         core/java/android/accounts/IAccountManagerResponse.aidl \
  77         core/java/android/accounts/IAccountAuthenticator.aidl \
  78         core/java/android/accounts/IAccountAuthenticatorResponse.aidl \
  79         core/java/android/app/IActivityController.aidl \
  80         core/java/android/app/IActivityPendingResult.aidl \
  81         core/java/android/app/IActivityWatcher.aidl \
  82         core/java/android/app/IAlarmManager.aidl \
  83         core/java/android/app/IBackupAgent.aidl \
  84         core/java/android/app/IInstrumentationWatcher.aidl \
  85         core/java/android/app/INotificationManager.aidl \
  86         core/java/android/app/ISearchManager.aidl \
  87         core/java/android/app/ISearchManagerCallback.aidl \
  88         core/java/android/app/IServiceConnection.aidl \
  89         core/java/android/app/IThumbnailReceiver.aidl \
  90         core/java/android/app/ITransientNotification.aidl \
  91         core/java/android/app/IUiModeManager.aidl \
  92         core/java/android/app/IWallpaperManager.aidl \
  93         core/java/android/app/IWallpaperManagerCallback.aidl \
  94         core/java/android/app/admin/IDevicePolicyManager.aidl \
  95         core/java/android/app/backup/IBackupManager.aidl \
  96         core/java/android/app/backup/IRestoreObserver.aidl \
  97         core/java/android/app/backup/IRestoreSession.aidl \
  98         core/java/android/bluetooth/IBluetooth.aidl \
  99         core/java/android/bluetooth/IBluetoothA2dp.aidl \
 100         core/java/android/bluetooth/IBluetoothCallback.aidl \
 101         core/java/android/bluetooth/IBluetoothHeadset.aidl \
 102         core/java/android/bluetooth/IBluetoothPbap.aidl \
 103         core/java/android/content/IClipboard.aidl \
 104         core/java/android/content/IContentService.aidl \
 105         core/java/android/content/IIntentReceiver.aidl \
 106         core/java/android/content/IIntentSender.aidl \
 107         core/java/android/content/IOnPrimaryClipChangedListener.aidl \
 108         core/java/android/content/ISyncAdapter.aidl \
 109         core/java/android/content/ISyncContext.aidl \
 110         core/java/android/content/ISyncStatusObserver.aidl \
 111         core/java/android/content/pm/IPackageDataObserver.aidl \
 112         core/java/android/content/pm/IPackageDeleteObserver.aidl \
 113         core/java/android/content/pm/IPackageInstallObserver.aidl \
 114         core/java/android/content/pm/IPackageManager.aidl \
 115         core/java/android/content/pm/IPackageMoveObserver.aidl \
 116         core/java/android/content/pm/IPackageStatsObserver.aidl \
 117         core/java/android/database/IContentObserver.aidl \
 118         core/java/android/hardware/usb/IUsbManager.aidl \
 119         core/java/android/net/IConnectivityManager.aidl \
 120         core/java/android/net/INetworkManagementEventObserver.aidl \
 121         core/java/android/net/IThrottleManager.aidl \
 122         core/java/android/nfc/ILlcpConnectionlessSocket.aidl \
 123         core/java/android/nfc/ILlcpServiceSocket.aidl \
 124         core/java/android/nfc/ILlcpSocket.aidl \
 125         core/java/android/nfc/INfcAdapter.aidl \
 126         core/java/android/nfc/INfcTag.aidl \
 127         core/java/android/nfc/IP2pInitiator.aidl \
 128         core/java/android/nfc/IP2pTarget.aidl \
 129     core/java/android/nfc/INfcSecureElement.aidl \
 130         core/java/android/os/IHardwareService.aidl \
 131         core/java/android/os/IMessenger.aidl \
 132         core/java/android/os/INetworkManagementService.aidl \
 133         core/java/android/os/INetStatService.aidl \
 134         core/java/android/os/IPermissionController.aidl \
 135         core/java/android/os/IPowerManager.aidl \
 136     core/java/android/os/IRemoteCallback.aidl \
 137         core/java/android/os/IVibratorService.aidl \
 138     core/java/android/service/wallpaper/IWallpaperConnection.aidl \
 139     core/java/android/service/wallpaper/IWallpaperEngine.aidl \
 140     core/java/android/service/wallpaper/IWallpaperService.aidl \
 141         core/java/android/view/accessibility/IAccessibilityManager.aidl \
 142         core/java/android/view/accessibility/IAccessibilityManagerClient.aidl \
 143         core/java/android/view/IApplicationToken.aidl \
 144         core/java/android/view/IOnKeyguardExitResult.aidl \
 145         core/java/android/view/IRotationWatcher.aidl \
 146         core/java/android/view/IWindow.aidl \
 147         core/java/android/view/IWindowManager.aidl \
 148         core/java/android/view/IWindowSession.aidl \
 149         core/java/android/speech/IRecognitionListener.aidl \
 150         core/java/android/speech/IRecognitionService.aidl \
 151         core/java/android/speech/tts/ITts.aidl \
 152         core/java/android/speech/tts/ITtsCallback.aidl \
 153         core/java/com/android/internal/app/IBatteryStats.aidl \
 154         core/java/com/android/internal/app/IUsageStats.aidl \
 155         core/java/com/android/internal/app/IMediaContainerService.aidl \
 156         core/java/com/android/internal/appwidget/IAppWidgetService.aidl \
 157         core/java/com/android/internal/appwidget/IAppWidgetHost.aidl \
 158         core/java/com/android/internal/backup/IBackupTransport.aidl \
 159         core/java/com/android/internal/os/IDropBoxManagerService.aidl \
 160         core/java/com/android/internal/os/IResultReceiver.aidl \
 161         core/java/com/android/internal/statusbar/IStatusBar.aidl \
 162         core/java/com/android/internal/statusbar/IStatusBarService.aidl \
 163         core/java/com/android/internal/view/IInputContext.aidl \
 164         core/java/com/android/internal/view/IInputContextCallback.aidl \
 165         core/java/com/android/internal/view/IInputMethod.aidl \
 166         core/java/com/android/internal/view/IInputMethodCallback.aidl \
 167         core/java/com/android/internal/view/IInputMethodClient.aidl \
 168         core/java/com/android/internal/view/IInputMethodManager.aidl \
 169         core/java/com/android/internal/view/IInputMethodSession.aidl \
 170         core/java/com/android/internal/widget/IRemoteViewsFactory.aidl \
 171         core/java/com/android/internal/widget/IRemoteViewsAdapterConnection.aidl \
 172         location/java/android/location/ICountryDetector.aidl \
 173         location/java/android/location/ICountryListener.aidl \
 174         location/java/android/location/IGeocodeProvider.aidl \
 175         location/java/android/location/IGpsStatusListener.aidl \
 176         location/java/android/location/IGpsStatusProvider.aidl \
 177         location/java/android/location/ILocationListener.aidl \
 178         location/java/android/location/ILocationManager.aidl \
 179         location/java/android/location/ILocationProvider.aidl \
 180         location/java/android/location/INetInitiatedListener.aidl \
 181         media/java/android/media/IAudioService.aidl \
 182         media/java/android/media/IAudioFocusDispatcher.aidl \
 183         media/java/android/media/IMediaScannerListener.aidl \
 184         media/java/android/media/IMediaScannerService.aidl \
 185         telephony/java/com/android/internal/telephony/IPhoneStateListener.aidl \
 186         telephony/java/com/android/internal/telephony/IPhoneSubInfo.aidl \
 187         telephony/java/com/android/internal/telephony/ITelephony.aidl \
 188         telephony/java/com/android/internal/telephony/ITelephonyRegistry.aidl \
 189         telephony/java/com/android/internal/telephony/IIccPhoneBook.aidl \
 190         telephony/java/com/android/internal/telephony/ISms.aidl \
 191         telephony/java/com/android/internal/telephony/IWapPushManager.aidl \
 192         wifi/java/android/net/wifi/IWifiManager.aidl \
 193         telephony/java/com/android/internal/telephony/IExtendedNetworkService.aidl \
 194         vpn/java/android/net/vpn/IVpnService.aidl \
 195         voip/java/android/net/sip/ISipSession.aidl \
 196         voip/java/android/net/sip/ISipSessionListener.aidl \
 197         voip/java/android/net/sip/ISipService.aidl
 198 #
 199
 200
 201 # FRAMEWORKS_BASE_JAVA_SRC_DIRS comes from build/core/pathmap.mk
 202 LOCAL_AIDL_INCLUDES += $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
 203
 204 LOCAL_INTERMEDIATE_SOURCES := \
 205                         $(framework_res_source_path)/android/R.java \
 206                         $(framework_res_source_path)/android/Manifest.java \
 207                         $(framework_res_source_path)/com/android/internal/R.java
 208
 209 LOCAL_NO_STANDARD_LIBRARIES := true
 210 LOCAL_JAVA_LIBRARIES := bouncycastle core core-junit ext
 211
 212 LOCAL_MODULE := framework
 213 LOCAL_MODULE_CLASS := JAVA_LIBRARIES
 214
 215 LOCAL_NO_EMMA_INSTRUMENT := true
 216 LOCAL_NO_EMMA_COMPILE := true
 217
 218 # List of classes and interfaces which should be loaded by the Zygote.
 219 LOCAL_JAVA_RESOURCE_FILES += $(LOCAL_PATH)/preloaded-classes
 220
 221 #LOCAL_JARJAR_RULES := $(LOCAL_PATH)/jarjar-rules.txt
 222
 223 LOCAL_DX_FLAGS := --core-library
 224
 225 include $(BUILD_JAVA_LIBRARY)
 226
 227 # Make sure that R.java and Manifest.java are built before we build
 228 # the source for this library.
 229 framework_res_R_stamp := \
 230         $(call intermediates-dir-for,APPS,framework-res,,COMMON)/src/R.stamp
 231 $(full_classes_compiled_jar): $(framework_res_R_stamp)
 232
 233 # Make sure that framework-res is installed when framework is.
 234 $(LOCAL_INSTALLED_MODULE): | $(dir $(LOCAL_INSTALLED_MODULE))framework-res.apk
 235
 236 framework_built := $(LOCAL_BUILT_MODULE)
 237
 238 # AIDL files to be preprocessed and included in the SDK,
 239 # relative to the root of the build tree.
 240 # ============================================================
 241 aidl_files := \
 242         frameworks/base/core/java/android/accounts/IAccountManager.aidl \
 243         frameworks/base/core/java/android/accounts/IAccountManagerResponse.aidl \
 244         frameworks/base/core/java/android/accounts/IAccountAuthenticator.aidl \
 245         frameworks/base/core/java/android/accounts/IAccountAuthenticatorResponse.aidl \
 246         frameworks/base/core/java/android/app/Notification.aidl \
 247         frameworks/base/core/java/android/app/PendingIntent.aidl \
 248         frameworks/base/core/java/android/bluetooth/BluetoothDevice.aidl \
 249         frameworks/base/core/java/android/content/ComponentName.aidl \
 250         frameworks/base/core/java/android/content/Intent.aidl \
 251         frameworks/base/core/java/android/content/IntentSender.aidl \
 252         frameworks/base/core/java/android/content/PeriodicSync.aidl \
 253         frameworks/base/core/java/android/content/SyncStats.aidl \
 254         frameworks/base/core/java/android/content/res/Configuration.aidl \
 255         frameworks/base/core/java/android/appwidget/AppWidgetProviderInfo.aidl \
 256         frameworks/base/core/java/android/net/Uri.aidl \
 257         frameworks/base/core/java/android/nfc/NdefMessage.aidl \
 258         frameworks/base/core/java/android/nfc/NdefRecord.aidl \
 259         frameworks/base/core/java/android/nfc/Tag.aidl \
 260         frameworks/base/core/java/android/os/Bundle.aidl \
 261         frameworks/base/core/java/android/os/DropBoxManager.aidl \
 262         frameworks/base/core/java/android/os/ParcelFileDescriptor.aidl \
 263         frameworks/base/core/java/android/os/ParcelUuid.aidl \
 264         frameworks/base/core/java/android/view/KeyEvent.aidl \
 265         frameworks/base/core/java/android/view/MotionEvent.aidl \
 266         frameworks/base/core/java/android/view/Surface.aidl \
 267         frameworks/base/core/java/android/view/WindowManager.aidl \
 268         frameworks/base/core/java/android/widget/RemoteViews.aidl \
 269         frameworks/base/core/java/com/android/internal/view/IInputContext.aidl \
 270         frameworks/base/core/java/com/android/internal/view/IInputMethod.aidl \
 271         frameworks/base/core/java/com/android/internal/view/IInputMethodCallback.aidl \
 272         frameworks/base/core/java/com/android/internal/view/IInputMethodClient.aidl \
 273         frameworks/base/core/java/com/android/internal/view/IInputMethodManager.aidl \
 274         frameworks/base/core/java/com/android/internal/view/IInputMethodSession.aidl \
 275         frameworks/base/graphics/java/android/graphics/Bitmap.aidl \
 276         frameworks/base/graphics/java/android/graphics/Rect.aidl \
 277         frameworks/base/graphics/java/android/graphics/Region.aidl \
 278         frameworks/base/location/java/android/location/Criteria.aidl \
 279         frameworks/base/location/java/android/location/Location.aidl \
 280         frameworks/base/telephony/java/android/telephony/ServiceState.aidl \
 281         frameworks/base/telephony/java/com/android/internal/telephony/IPhoneSubInfo.aidl \
 282         frameworks/base/telephony/java/com/android/internal/telephony/ITelephony.aidl \
 283         frameworks/base/vpn/java/android/net/vpn/IVpnService.aidl \
 284
 285 gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
 286 $(gen): PRIVATE_SRC_FILES := $(aidl_files)
 287 ALL_SDK_FILES += $(gen)
 288 $(gen): $(aidl_files) | $(AIDL)
 289                 @echo Aidl Preprocess: $@
 290                 $(hide) $(AIDL) --preprocess $@ $(PRIVATE_SRC_FILES)
 291
 292 # the documentation
 293 # ============================================================
 294
 295 # TODO: deal with com/google/android/googleapps
 296 packages_to_document := \
 297         android \
 298         javax/microedition/khronos
 299
 300 # Search through the base framework dirs for these packages.
 301 # The result will be relative to frameworks/base.
 302 fwbase_dirs_to_document := \
 303         test-runner/src \
 304         $(patsubst $(LOCAL_PATH)/%,%, \
 305           $(wildcard \
 306             $(foreach dir, $(FRAMEWORKS_BASE_JAVA_SRC_DIRS), \
 307               $(addprefix $(dir)/, $(packages_to_document)) \
 308              ) \
 309            ) \
 310          )
 311
 312 # Pass a special "fake-out" version of some classes to the doc/API tools.
 313 # ConfigBuildFlags uses this trick to prevent certain fields from appearing
 314 # as "final" in the official SDK APIs.
 315 fwbase_dirs_to_document += core/config/sdk
 316
 317 # include definition of libcore_to_document
 318 # These are relative to libcore
 319 include $(LOCAL_PATH)/../../libcore/Docs.mk
 320
 321 non_base_dirs := \
 322         ../../external/apache-http/src/org/apache/http
 323
 324 # These are relative to frameworks/base
 325 dirs_to_document := \
 326         $(fwbase_dirs_to_document) \
 327         $(non_base_dirs) \
 328         $(addprefix ../../libcore/, $(libcore_to_document))
 329
 330 html_dirs := \
 331         $(FRAMEWORKS_BASE_SUBDIRS) \
 332         $(non_base_dirs)
 333
 334 # These are relative to frameworks/base
 335 framework_docs_LOCAL_SRC_FILES := \
 336         $(call find-other-java-files, $(dirs_to_document)) \
 337         $(call find-other-html-files, $(html_dirs))
 338
 339 # This is used by ide.mk as the list of source files that are
 340 # always included.
 341 INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
 342
 343 framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
 344         $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
 345
 346 framework_docs_LOCAL_INTERMEDIATE_SOURCES := \
 347                         $(framework_res_source_path)/android/R.java \
 348                         $(framework_res_source_path)/android/Manifest.java \
 349                         $(framework_res_source_path)/com/android/internal/R.java
 350
 351 framework_docs_LOCAL_JAVA_LIBRARIES := \
 352                         bouncycastle \
 353                         core \
 354                         ext \
 355                         framework \
 356
 357 framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES
 358 framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html
 359 # The since flag (-since N.xml API_LEVEL) is used to add API Level information
 360 # to the reference documentation. Must be in order of oldest to newest.
 361 framework_docs_LOCAL_DROIDDOC_OPTIONS := \
 362     -knowntags ./frameworks/base/docs/knowntags.txt \
 363     -since ./frameworks/base/api/1.xml 1 \
 364     -since ./frameworks/base/api/2.xml 2 \
 365     -since ./frameworks/base/api/3.xml 3 \
 366     -since ./frameworks/base/api/4.xml 4 \
 367     -since ./frameworks/base/api/5.xml 5 \
 368     -since ./frameworks/base/api/6.xml 6 \
 369     -since ./frameworks/base/api/7.xml 7 \
 370     -since ./frameworks/base/api/8.xml 8 \
 371     -since ./frameworks/base/api/9.xml 9 \
 372     -since ./frameworks/base/api/10.xml 10 \
 373     -since ./frameworks/base/api/11.xml 11 \
 374     -since ./frameworks/base/api/12.xml 12 \
 375     -since ./frameworks/base/api/13.xml 13 \
 376                 -werror -hide 113 \
 377                 -overview $(LOCAL_PATH)/core/java/overview.html
 378
 379 framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= $(call intermediates-dir-for,JAVA_LIBRARIES,framework)
 380
 381 framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
 382     frameworks/base/docs/knowntags.txt
 383
 384 sample_dir := development/samples
 385
 386 # the list here should match the list of samples included in the sdk samples package
 387 # (see development/build/sdk.atree)
 388 web_docs_sample_code_flags := \
 389                 -hdf android.hasSamples 1 \
 390                 -samplecode $(sample_dir)/AccessibilityService \
 391                             resources/samples/AccessibilityService "Accessibility Service" \
 392                 -samplecode $(sample_dir)/AccelerometerPlay \
 393                             resources/samples/AccelerometerPlay "Accelerometer Play" \
 394                 -samplecode $(sample_dir)/ApiDemos \
 395                             resources/samples/ApiDemos "API Demos" \
 396                 -samplecode $(sample_dir)/Support4Demos \
 397                             resources/samples/Support4Demos "API 4+ Support Demos" \
 398                 -samplecode $(sample_dir)/Support13Demos \
 399                             resources/samples/Support13Demos "API 13+ Support Demos" \
 400                 -samplecode $(sample_dir)/BackupRestore \
 401                             resources/samples/BackupRestore "Backup and Restore" \
 402                 -samplecode $(sample_dir)/BluetoothChat \
 403                             resources/samples/BluetoothChat "Bluetooth Chat" \
 404                 -samplecode $(sample_dir)/BusinessCard \
 405                             resources/samples/BusinessCard "Business Card" \
 406                 -samplecode $(sample_dir)/ContactManager \
 407                             resources/samples/ContactManager "Contact Manager" \
 408     -samplecode $(sample_dir)/CubeLiveWallpaper \
 409                 resources/samples/CubeLiveWallpaper "Cube Live Wallpaper" \
 410                 -samplecode $(sample_dir)/Home \
 411                             resources/samples/Home "Home" \
 412                 -samplecode $(sample_dir)/HoneycombGallery \
 413                             resources/samples/HoneycombGallery "Honeycomb Gallery" \
 414                 -samplecode $(sample_dir)/JetBoy \
 415                             resources/samples/JetBoy "JetBoy" \
 416                 -samplecode $(sample_dir)/LunarLander \
 417                             resources/samples/LunarLander "Lunar Lander" \
 418                 -samplecode $(sample_dir)/MultiResolution \
 419                             resources/samples/MultiResolution "Multiple Resolutions" \
 420                 -samplecode $(sample_dir)/NFCDemo \
 421                             resources/samples/NFCDemo "NFC Demo" \
 422                 -samplecode $(sample_dir)/NotePad \
 423                             resources/samples/NotePad "Note Pad" \
 424                 -samplecode $(sample_dir)/SampleSyncAdapter \
 425                             resources/samples/SampleSyncAdapter "Sample Sync Adapter" \
 426                 -samplecode $(sample_dir)/RandomMusicPlayer \
 427                             resources/samples/RandomMusicPlayer "Random Music Player" \
 428                 -samplecode $(sample_dir)/RenderScript \
 429                             resources/samples/RenderScript "RenderScript" \
 430                 -samplecode $(sample_dir)/SearchableDictionary \
 431                             resources/samples/SearchableDictionary "Searchable Dictionary v2" \
 432                 -samplecode $(sample_dir)/SipDemo \
 433                             resources/samples/SipDemo "SIP Demo" \
 434                 -samplecode $(sample_dir)/Snake \
 435                             resources/samples/Snake "Snake" \
 436                 -samplecode $(sample_dir)/SoftKeyboard \
 437                             resources/samples/SoftKeyboard "Soft Keyboard" \
 438                 -samplecode $(sample_dir)/Spinner  \
 439                             resources/samples/Spinner "Spinner" \
 440                 -samplecode $(sample_dir)/SpinnerTest \
 441                             resources/samples/SpinnerTest "SpinnerTest" \
 442                 -samplecode $(sample_dir)/StackWidget \
 443                             resources/samples/StackWidget "StackView Widget" \
 444                 -samplecode $(sample_dir)/TicTacToeLib  \
 445                             resources/samples/TicTacToeLib "TicTacToeLib" \
 446                 -samplecode $(sample_dir)/TicTacToeMain \
 447                             resources/samples/TicTacToeMain "TicTacToeMain" \
 448                 -samplecode $(sample_dir)/USB \
 449                             resources/samples/USB "USB" \
 450                 -samplecode $(sample_dir)/WeatherListWidget \
 451                             resources/samples/WeatherListWidget "Weather List Widget" \
 452                 -samplecode $(sample_dir)/Wiktionary \
 453                             resources/samples/Wiktionary "Wiktionary" \
 454                 -samplecode $(sample_dir)/WiktionarySimple \
 455                             resources/samples/WiktionarySimple "Wiktionary (Simplified)" \
 456                 -samplecode $(sample_dir)/VoiceRecognitionService \
 457                             resources/samples/VoiceRecognitionService "Voice Recognition Service" \
 458                 -samplecode $(sample_dir)/XmlAdapters \
 459                             resources/samples/XmlAdapters "XML Adapters"
 460
 461 ## SDK version identifiers used in the published docs
 462   # major[.minor] version for current SDK. (full releases only)
 463 framework_docs_SDK_VERSION:=3.1
 464   # release version (ie "Release x")  (full releases only)
 465 framework_docs_SDK_REL_ID:=1
 466
 467 framework_docs_LOCAL_DROIDDOC_OPTIONS += \
 468                 -hdf sdk.version $(framework_docs_SDK_VERSION) \
 469                 -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
 470                 -hdf sdk.preview 0 \
 471
 472 # ====  the api stubs and current.xml ===========================
 473 include $(CLEAR_VARS)
 474
 475 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 476 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 477 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 478 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 479 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 480 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 481 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 482 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 483
 484 LOCAL_MODULE := api-stubs
 485
 486 LOCAL_DROIDDOC_OPTIONS:=\
 487                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 488                 -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src \
 489                 -apixml $(INTERNAL_PLATFORM_API_FILE) \
 490                 -nodocs
 491
 492 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 493
 494 LOCAL_UNINSTALLABLE_MODULE := true
 495
 496 include $(BUILD_DROIDDOC)
 497
 498 # $(gen), i.e. framework.aidl, is also needed while building against the current stub.
 499 $(full_target): $(framework_built) $(gen)
 500 $(INTERNAL_PLATFORM_API_FILE): $(full_target)
 501 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
 502
 503 # ====  check javadoc comments but don't generate docs ========
 504 include $(CLEAR_VARS)
 505
 506 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 507 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 508 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 509 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 510 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 511 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 512 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 513 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 514
 515 LOCAL_MODULE := doc-comment-check
 516
 517 LOCAL_DROIDDOC_OPTIONS:=\
 518                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 519                 -parsecomments
 520
 521 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 522
 523 LOCAL_UNINSTALLABLE_MODULE := true
 524
 525 include $(BUILD_DROIDDOC)
 526
 527 # $(gen), i.e. framework.aidl, is also needed while building against the current stub.
 528 $(full_target): $(framework_built) $(gen)
 529
 530 droidcore: doc-comment-check-docs
 531
 532 # ====  static html in the sdk ==================================
 533 include $(CLEAR_VARS)
 534
 535 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 536 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 537 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 538 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 539 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 540 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 541 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 542 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 543
 544 LOCAL_MODULE := offline-sdk
 545
 546 LOCAL_DROIDDOC_OPTIONS:=\
 547                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 548                 $(web_docs_sample_code_flags) \
 549                 -offlinemode \
 550                 -title "Android SDK" \
 551                 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
 552                 -todo $(OUT_DOCS)/$(LOCAL_MODULE)-docs-todo.html \
 553                 -sdkvalues $(OUT_DOCS) \
 554                 -hdf android.whichdoc offline
 555
 556
 557 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 558
 559 include $(BUILD_DROIDDOC)
 560
 561 static_doc_index_redirect := $(out_dir)/index.html
 562 $(static_doc_index_redirect): \
 563         $(LOCAL_PATH)/docs/docs-documentation-redirect.html | $(ACP)
 564         $(hide) mkdir -p $(dir $@)
 565         $(hide) $(ACP) $< $@
 566
 567 $(full_target): $(static_doc_index_redirect)
 568 $(full_target): $(framework_built)
 569
 570 # ==== docs for the web (on the google app engine server) =======================
 571 include $(CLEAR_VARS)
 572
 573 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 574 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 575 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 576 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 577 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 578 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 579 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 580 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 581 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 582
 583 LOCAL_MODULE := online-sdk
 584
 585 LOCAL_DROIDDOC_OPTIONS:= \
 586                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 587                 $(web_docs_sample_code_flags) \
 588                 -toroot / \
 589                 -hdf android.whichdoc online \
 590                 -hdf template.showLanguageMenu true
 591
 592 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 593
 594 include $(BUILD_DROIDDOC)
 595
 596 # explicitly specify that online-sdk depends on framework-res and any generated docs
 597 $(full_target): framework-res-package-target
 598
 599 # ==== docs that have all of the stuff that's @hidden =======================
 600 include $(CLEAR_VARS)
 601
 602 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 603 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 604 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) framework
 605 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 606 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 607 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 608 LOCAL_ADDITIONAL_JAVA_DIR:=$(call intermediates-dir-for,JAVA_LIBRARIES,framework)
 609 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 610
 611 LOCAL_MODULE := hidden
 612 LOCAL_DROIDDOC_OPTIONS:=\
 613                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 614                 -title "Android SDK - Including hidden APIs."
 615 #               -hidden
 616
 617 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 618
 619 include $(BUILD_DROIDDOC)
 620
 621 # Build ext.jar
 622 # ============================================================
 623
 624 # NOTICE notes for non-obvious sections
 625 # apache-http - covered by the Apache Commons section.
 626
 627
 628 ext_dirs := \
 629         ../../external/nist-sip/java \
 630         ../../external/apache-http/src \
 631         ../../external/tagsoup/src \
 632         ../../external/libphonenumber/java/src
 633
 634 ext_src_files := $(call all-java-files-under,$(ext_dirs))
 635
 636 ext_res_dirs := \
 637         ../../external/libphonenumber/java/src
 638
 639 # ====  the library  =========================================
 640 include $(CLEAR_VARS)
 641
 642 LOCAL_SRC_FILES := $(ext_src_files)
 643
 644 LOCAL_NO_STANDARD_LIBRARIES := true
 645 LOCAL_JAVA_LIBRARIES := core
 646 LOCAL_JAVA_RESOURCE_DIRS := $(ext_res_dirs)
 647 LOCAL_MODULE_TAGS := optional
 648 LOCAL_MODULE := ext
 649
 650 LOCAL_NO_EMMA_INSTRUMENT := true
 651 LOCAL_NO_EMMA_COMPILE := true
 652
 653 include $(BUILD_JAVA_LIBRARY)
 654
 655
 656 # Include subdirectory makefiles
 657 # ============================================================
 658
 659 # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
 660 # team really wants is to build the stuff defined by this makefile.
 661 ifeq (,$(ONE_SHOT_MAKEFILE))
 662 include $(call first-makefiles-under,$(LOCAL_PATH))
 663 endif