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/speech/tts/EventLogTags.logtags \
  40        core/java/android/webkit/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 ## READ ME: ########################################################
  51 ##
  52 ## When updating this list of aidl files, consider if that aidl is
  53 ## part of the SDK API.  If it is, also add it to the list below that
  54 ## is preprocessed and distributed with the SDK.  This list should
  55 ## not contain any aidl files for parcelables, but the one below should
  56 ## if you intend for 3rd parties to be able to send those objects
  57 ## across process boundaries.
  58 ##
  59 ## READ ME: ########################################################
  60 LOCAL_SRC_FILES += \
  61         core/java/android/accessibilityservice/IAccessibilityServiceConnection.aidl \
  62         core/java/android/accessibilityservice/IAccessibilityServiceClient.aidl \
  63         core/java/android/accounts/IAccountManager.aidl \
  64         core/java/android/accounts/IAccountManagerResponse.aidl \
  65         core/java/android/accounts/IAccountAuthenticator.aidl \
  66         core/java/android/accounts/IAccountAuthenticatorResponse.aidl \
  67         core/java/android/app/IActivityController.aidl \
  68         core/java/android/app/IActivityPendingResult.aidl \
  69         core/java/android/app/IAlarmManager.aidl \
  70         core/java/android/app/IBackupAgent.aidl \
  71         core/java/android/app/IInstrumentationWatcher.aidl \
  72         core/java/android/app/INotificationListener.aidl \
  73         core/java/android/app/INotificationManager.aidl \
  74         core/java/android/app/IProcessObserver.aidl \
  75         core/java/android/app/ISearchManager.aidl \
  76         core/java/android/app/ISearchManagerCallback.aidl \
  77         core/java/android/app/IServiceConnection.aidl \
  78         core/java/android/app/IStopUserCallback.aidl \
  79         core/java/android/app/IThumbnailReceiver.aidl \
  80         core/java/android/app/IThumbnailRetriever.aidl \
  81         core/java/android/app/ITransientNotification.aidl \
  82         core/java/android/app/IUiAutomationConnection.aidl \
  83         core/java/android/app/IUiModeManager.aidl \
  84         core/java/android/app/IUserSwitchObserver.aidl \
  85         core/java/android/app/IWallpaperManager.aidl \
  86         core/java/android/app/IWallpaperManagerCallback.aidl \
  87         core/java/android/app/admin/IDevicePolicyManager.aidl \
  88         core/java/android/app/backup/IBackupManager.aidl \
  89         core/java/android/app/backup/IFullBackupRestoreObserver.aidl \
  90         core/java/android/app/backup/IRestoreObserver.aidl \
  91         core/java/android/app/backup/IRestoreSession.aidl \
  92         core/java/android/bluetooth/IBluetooth.aidl \
  93         core/java/android/bluetooth/IBluetoothA2dp.aidl \
  94         core/java/android/bluetooth/IBluetoothCallback.aidl \
  95         core/java/android/bluetooth/IBluetoothHeadset.aidl \
  96         core/java/android/bluetooth/IBluetoothHeadsetPhone.aidl \
  97         core/java/android/bluetooth/IBluetoothHealth.aidl \
  98         core/java/android/bluetooth/IBluetoothHealthCallback.aidl \
  99         core/java/android/bluetooth/IBluetoothInputDevice.aidl \
 100         core/java/android/bluetooth/IBluetoothPan.aidl \
 101         core/java/android/bluetooth/IBluetoothManager.aidl \
 102         core/java/android/bluetooth/IBluetoothManagerCallback.aidl \
 103         core/java/android/bluetooth/IBluetoothPbap.aidl \
 104         core/java/android/bluetooth/IBluetoothStateChangeCallback.aidl \
 105         core/java/android/bluetooth/IBluetoothGatt.aidl \
 106         core/java/android/bluetooth/IBluetoothGattCallback.aidl \
 107         core/java/android/bluetooth/IBluetoothGattServerCallback.aidl \
 108         core/java/android/content/IClipboard.aidl \
 109         core/java/android/content/IContentService.aidl \
 110         core/java/android/content/IIntentReceiver.aidl \
 111         core/java/android/content/IIntentSender.aidl \
 112         core/java/android/content/IOnPrimaryClipChangedListener.aidl \
 113         core/java/android/content/ISyncAdapter.aidl \
 114         core/java/android/content/ISyncContext.aidl \
 115         core/java/android/content/ISyncStatusObserver.aidl \
 116         core/java/android/content/pm/IPackageDataObserver.aidl \
 117         core/java/android/content/pm/IPackageDeleteObserver.aidl \
 118         core/java/android/content/pm/IPackageInstallObserver.aidl \
 119         core/java/android/content/pm/IPackageManager.aidl \
 120         core/java/android/content/pm/IPackageMoveObserver.aidl \
 121         core/java/android/content/pm/IPackageStatsObserver.aidl \
 122         core/java/android/database/IContentObserver.aidl \
 123         core/java/android/hardware/ISerialManager.aidl \
 124         core/java/android/hardware/display/IDisplayManager.aidl \
 125         core/java/android/hardware/display/IDisplayManagerCallback.aidl \
 126         core/java/android/hardware/input/IInputManager.aidl \
 127         core/java/android/hardware/input/IInputDevicesChangedListener.aidl \
 128         core/java/android/hardware/usb/IUsbManager.aidl \
 129         core/java/android/net/IConnectivityManager.aidl \
 130         core/java/android/net/INetworkManagementEventObserver.aidl \
 131         core/java/android/net/INetworkPolicyListener.aidl \
 132         core/java/android/net/INetworkPolicyManager.aidl \
 133         core/java/android/net/INetworkStatsService.aidl \
 134         core/java/android/net/INetworkStatsSession.aidl \
 135         core/java/android/net/nsd/INsdManager.aidl \
 136         core/java/android/nfc/INdefPushCallback.aidl \
 137         core/java/android/nfc/INfcAdapter.aidl \
 138         core/java/android/nfc/INfcAdapterExtras.aidl \
 139         core/java/android/nfc/INfcTag.aidl \
 140         core/java/android/os/ICancellationSignal.aidl \
 141         core/java/android/os/IHardwareService.aidl \
 142         core/java/android/os/IMessenger.aidl \
 143         core/java/android/os/INetworkManagementService.aidl \
 144         core/java/android/os/IPermissionController.aidl \
 145         core/java/android/os/IPowerManager.aidl \
 146         core/java/android/os/IRemoteCallback.aidl \
 147         core/java/android/os/ISchedulingPolicyService.aidl \
 148         core/java/android/os/IUpdateLock.aidl \
 149         core/java/android/os/IUserManager.aidl \
 150         core/java/android/os/IVibratorService.aidl \
 151         core/java/android/service/dreams/IDreamManager.aidl \
 152         core/java/android/service/dreams/IDreamService.aidl \
 153         core/java/android/service/wallpaper/IWallpaperConnection.aidl \
 154         core/java/android/service/wallpaper/IWallpaperEngine.aidl \
 155         core/java/android/service/wallpaper/IWallpaperService.aidl \
 156         core/java/android/view/accessibility/IAccessibilityInteractionConnection.aidl\
 157         core/java/android/view/accessibility/IAccessibilityInteractionConnectionCallback.aidl\
 158         core/java/android/view/accessibility/IAccessibilityManager.aidl \
 159         core/java/android/view/accessibility/IAccessibilityManagerClient.aidl \
 160         core/java/android/view/IApplicationToken.aidl \
 161         core/java/android/view/IMagnificationCallbacks.aidl \
 162         core/java/android/view/IInputFilter.aidl \
 163         core/java/android/view/IInputFilterHost.aidl \
 164         core/java/android/view/IOnKeyguardExitResult.aidl \
 165         core/java/android/view/IRotationWatcher.aidl \
 166         core/java/android/view/IWindow.aidl \
 167         core/java/android/view/IWindowFocusObserver.aidl \
 168         core/java/android/view/IWindowId.aidl \
 169         core/java/android/view/IWindowManager.aidl \
 170         core/java/android/view/IWindowSession.aidl \
 171         core/java/android/speech/IRecognitionListener.aidl \
 172         core/java/android/speech/IRecognitionService.aidl \
 173         core/java/android/speech/tts/ITextToSpeechCallback.aidl \
 174         core/java/android/speech/tts/ITextToSpeechService.aidl \
 175         core/java/com/android/internal/app/IAppOpsCallback.aidl \
 176         core/java/com/android/internal/app/IAppOpsService.aidl \
 177         core/java/com/android/internal/app/IBatteryStats.aidl \
 178         core/java/com/android/internal/app/IUsageStats.aidl \
 179         core/java/com/android/internal/app/IMediaContainerService.aidl \
 180         core/java/com/android/internal/appwidget/IAppWidgetService.aidl \
 181         core/java/com/android/internal/appwidget/IAppWidgetHost.aidl \
 182         core/java/com/android/internal/backup/IBackupTransport.aidl \
 183         core/java/com/android/internal/backup/IObbBackupService.aidl \
 184         core/java/com/android/internal/policy/IFaceLockCallback.aidl \
 185         core/java/com/android/internal/policy/IFaceLockInterface.aidl \
 186         core/java/com/android/internal/os/IDropBoxManagerService.aidl \
 187         core/java/com/android/internal/os/IResultReceiver.aidl \
 188         core/java/com/android/internal/statusbar/IStatusBar.aidl \
 189         core/java/com/android/internal/statusbar/IStatusBarService.aidl \
 190         core/java/com/android/internal/textservice/ISpellCheckerService.aidl \
 191         core/java/com/android/internal/textservice/ISpellCheckerSession.aidl \
 192         core/java/com/android/internal/textservice/ISpellCheckerSessionListener.aidl \
 193         core/java/com/android/internal/textservice/ITextServicesManager.aidl \
 194         core/java/com/android/internal/textservice/ITextServicesSessionListener.aidl \
 195         core/java/com/android/internal/view/IInputContext.aidl \
 196         core/java/com/android/internal/view/IInputContextCallback.aidl \
 197         core/java/com/android/internal/view/IInputMethod.aidl \
 198         core/java/com/android/internal/view/IInputMethodCallback.aidl \
 199         core/java/com/android/internal/view/IInputMethodClient.aidl \
 200         core/java/com/android/internal/view/IInputMethodManager.aidl \
 201         core/java/com/android/internal/view/IInputMethodSession.aidl \
 202         core/java/com/android/internal/view/IInputSessionCallback.aidl \
 203         core/java/com/android/internal/widget/ILockSettings.aidl \
 204         core/java/com/android/internal/widget/IRemoteViewsFactory.aidl \
 205         core/java/com/android/internal/widget/IRemoteViewsAdapterConnection.aidl \
 206         keystore/java/android/security/IKeyChainAliasCallback.aidl \
 207         keystore/java/android/security/IKeyChainService.aidl \
 208         location/java/android/location/ICountryDetector.aidl \
 209         location/java/android/location/ICountryListener.aidl \
 210         location/java/android/location/IGeocodeProvider.aidl \
 211         location/java/android/location/IGpsStatusListener.aidl \
 212         location/java/android/location/IGpsStatusProvider.aidl \
 213         location/java/android/location/ILocationListener.aidl \
 214         location/java/android/location/ILocationManager.aidl \
 215         location/java/android/location/INetInitiatedListener.aidl \
 216         location/java/com/android/internal/location/ILocationProvider.aidl \
 217         media/java/android/media/IAudioService.aidl \
 218         media/java/android/media/IAudioFocusDispatcher.aidl \
 219         media/java/android/media/IAudioRoutesObserver.aidl \
 220         media/java/android/media/IMediaScannerListener.aidl \
 221         media/java/android/media/IMediaScannerService.aidl \
 222         media/java/android/media/IRemoteControlClient.aidl \
 223         media/java/android/media/IRemoteControlDisplay.aidl \
 224         media/java/android/media/IRemoteVolumeObserver.aidl \
 225         media/java/android/media/IRingtonePlayer.aidl \
 226         telephony/java/com/android/internal/telephony/IPhoneStateListener.aidl \
 227         telephony/java/com/android/internal/telephony/IPhoneSubInfo.aidl \
 228         telephony/java/com/android/internal/telephony/ITelephony.aidl \
 229         telephony/java/com/android/internal/telephony/ISms.aidl \
 230         telephony/java/com/android/internal/telephony/ITelephonyRegistry.aidl \
 231         telephony/java/com/android/internal/telephony/IWapPushManager.aidl \
 232         wifi/java/android/net/wifi/IWifiManager.aidl \
 233         wifi/java/android/net/wifi/p2p/IWifiP2pManager.aidl
 234 #
 235
 236
 237 # FRAMEWORKS_BASE_JAVA_SRC_DIRS comes from build/core/pathmap.mk
 238 LOCAL_AIDL_INCLUDES += $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
 239
 240 LOCAL_INTERMEDIATE_SOURCES := \
 241                         $(framework_res_source_path)/android/R.java \
 242                         $(framework_res_source_path)/android/Manifest.java \
 243                         $(framework_res_source_path)/com/android/internal/R.java
 244
 245 LOCAL_NO_STANDARD_LIBRARIES := true
 246 LOCAL_JAVA_LIBRARIES := bouncycastle core core-junit ext
 247
 248 LOCAL_MODULE := framework
 249 LOCAL_MODULE_CLASS := JAVA_LIBRARIES
 250
 251 # List of classes and interfaces which should be loaded by the Zygote.
 252 LOCAL_JAVA_RESOURCE_FILES += $(LOCAL_PATH)/preloaded-classes
 253
 254 #LOCAL_JARJAR_RULES := $(LOCAL_PATH)/jarjar-rules.txt
 255
 256 LOCAL_DX_FLAGS := --core-library
 257
 258 include $(BUILD_JAVA_LIBRARY)
 259
 260 # Make sure that R.java and Manifest.java are built before we build
 261 # the source for this library.
 262 framework_res_R_stamp := \
 263         $(call intermediates-dir-for,APPS,framework-res,,COMMON)/src/R.stamp
 264 $(full_classes_compiled_jar): $(framework_res_R_stamp)
 265
 266 # Make sure that framework-res is installed when framework is.
 267 $(LOCAL_INSTALLED_MODULE): | $(dir $(LOCAL_INSTALLED_MODULE))framework-res.apk
 268
 269 framework_built := $(call java-lib-deps,framework)
 270
 271 # AIDL files to be preprocessed and included in the SDK,
 272 # relative to the root of the build tree.
 273 # ============================================================
 274 aidl_files := \
 275         frameworks/base/core/java/android/accounts/IAccountManager.aidl \
 276         frameworks/base/core/java/android/accounts/IAccountManagerResponse.aidl \
 277         frameworks/base/core/java/android/accounts/IAccountAuthenticator.aidl \
 278         frameworks/base/core/java/android/accounts/IAccountAuthenticatorResponse.aidl \
 279         frameworks/base/core/java/android/app/Notification.aidl \
 280         frameworks/base/core/java/android/app/PendingIntent.aidl \
 281         frameworks/base/core/java/android/bluetooth/BluetoothDevice.aidl \
 282         frameworks/base/core/java/android/bluetooth/BluetoothHealthAppConfiguration.aidl \
 283         frameworks/base/core/java/android/content/ComponentName.aidl \
 284         frameworks/base/core/java/android/content/Intent.aidl \
 285         frameworks/base/core/java/android/content/IntentSender.aidl \
 286         frameworks/base/core/java/android/content/PeriodicSync.aidl \
 287         frameworks/base/core/java/android/content/SyncStats.aidl \
 288         frameworks/base/core/java/android/content/res/Configuration.aidl \
 289         frameworks/base/core/java/android/appwidget/AppWidgetProviderInfo.aidl \
 290         frameworks/base/core/java/android/net/Uri.aidl \
 291         frameworks/base/core/java/android/nfc/NdefMessage.aidl \
 292         frameworks/base/core/java/android/nfc/NdefRecord.aidl \
 293         frameworks/base/core/java/android/nfc/Tag.aidl \
 294         frameworks/base/core/java/android/os/Bundle.aidl \
 295         frameworks/base/core/java/android/os/DropBoxManager.aidl \
 296         frameworks/base/core/java/android/os/ParcelFileDescriptor.aidl \
 297         frameworks/base/core/java/android/os/ParcelUuid.aidl \
 298         frameworks/base/core/java/android/view/KeyEvent.aidl \
 299         frameworks/base/core/java/android/view/MotionEvent.aidl \
 300         frameworks/base/core/java/android/view/Surface.aidl \
 301         frameworks/base/core/java/android/view/WindowManager.aidl \
 302         frameworks/base/core/java/android/widget/RemoteViews.aidl \
 303         frameworks/base/core/java/com/android/internal/textservice/ISpellCheckerService.aidl \
 304         frameworks/base/core/java/com/android/internal/textservice/ISpellCheckerSession.aidl \
 305         frameworks/base/core/java/com/android/internal/textservice/ISpellCheckerSessionListener.aidl \
 306         frameworks/base/core/java/com/android/internal/textservice/ITextServicesManager.aidl \
 307         frameworks/base/core/java/com/android/internal/textservice/ITextServicesSessionListener.aidl \
 308         frameworks/base/core/java/com/android/internal/view/IInputContext.aidl \
 309         frameworks/base/core/java/com/android/internal/view/IInputMethod.aidl \
 310         frameworks/base/core/java/com/android/internal/view/IInputMethodCallback.aidl \
 311         frameworks/base/core/java/com/android/internal/view/IInputMethodClient.aidl \
 312         frameworks/base/core/java/com/android/internal/view/IInputMethodManager.aidl \
 313         frameworks/base/core/java/com/android/internal/view/IInputMethodSession.aidl \
 314         frameworks/base/graphics/java/android/graphics/Bitmap.aidl \
 315         frameworks/base/graphics/java/android/graphics/Rect.aidl \
 316         frameworks/base/graphics/java/android/graphics/Region.aidl \
 317         frameworks/base/location/java/android/location/Criteria.aidl \
 318         frameworks/base/location/java/android/location/Geofence.aidl \
 319         frameworks/base/location/java/android/location/Location.aidl \
 320         frameworks/base/location/java/android/location/LocationRequest.aidl \
 321         frameworks/base/location/java/com/android/internal/location/ProviderProperties.aidl \
 322         frameworks/base/location/java/com/android/internal/location/ProviderRequest.aidl \
 323         frameworks/base/telephony/java/android/telephony/ServiceState.aidl \
 324         frameworks/base/telephony/java/com/android/internal/telephony/IPhoneSubInfo.aidl \
 325         frameworks/base/telephony/java/com/android/internal/telephony/ITelephony.aidl \
 326
 327 gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
 328 $(gen): PRIVATE_SRC_FILES := $(aidl_files)
 329 ALL_SDK_FILES += $(gen)
 330 $(gen): $(aidl_files) | $(AIDL)
 331                 @echo Aidl Preprocess: $@
 332                 $(hide) $(AIDL) --preprocess $@ $(PRIVATE_SRC_FILES)
 333
 334 # the documentation
 335 # ============================================================
 336
 337 # TODO: deal with com/google/android/googleapps
 338 packages_to_document := \
 339         android \
 340         javax/microedition/khronos
 341
 342 # Search through the base framework dirs for these packages.
 343 # The result will be relative to frameworks/base.
 344 fwbase_dirs_to_document := \
 345         test-runner/src \
 346         $(patsubst $(LOCAL_PATH)/%,%, \
 347           $(wildcard \
 348             $(foreach dir, $(FRAMEWORKS_BASE_JAVA_SRC_DIRS), \
 349               $(addprefix $(dir)/, $(packages_to_document)) \
 350              ) \
 351            ) \
 352          )
 353
 354 # include definition of libcore_to_document
 355 include libcore/Docs.mk
 356
 357 # include definition of junit_to_document
 358 include external/junit/Common.mk
 359
 360 non_base_dirs := \
 361         ../../external/apache-http/src/org/apache/http \
 362         ../opt/telephony/src/java/android/telephony \
 363         ../opt/telephony/src/java/android/telephony/gsm \
 364         ../opt/net/voip/src/java/android/net/rtp \
 365         ../opt/net/voip/src/java/android/net/sip
 366
 367 # These are relative to frameworks/base
 368 dirs_to_check_apis := \
 369   $(fwbase_dirs_to_document) \
 370         $(non_base_dirs)
 371
 372 # These are relative to frameworks/base
 373 # FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
 374 dirs_to_document := \
 375         $(dirs_to_check_apis) \
 376   $(addprefix ../../, $(FRAMEWORKS_SUPPORT_JAVA_SRC_DIRS))
 377
 378 # These are relative to frameworks/base
 379 html_dirs := \
 380         $(FRAMEWORKS_BASE_SUBDIRS) \
 381         $(non_base_dirs)
 382
 383 # Common sources for doc check and api check
 384 common_src_files := \
 385         $(call find-other-html-files, $(html_dirs)) \
 386         $(addprefix ../../libcore/, $(call libcore_to_document, $(LOCAL_PATH)/../../libcore)) \
 387         $(addprefix ../../external/junit/, $(call junit_to_document, $(LOCAL_PATH)/../../external/junit))
 388
 389 # These are relative to frameworks/base
 390 framework_docs_LOCAL_SRC_FILES := \
 391         $(call find-other-java-files, $(dirs_to_document)) \
 392         $(common_src_files)
 393
 394 # These are relative to frameworks/base
 395 framework_docs_LOCAL_API_CHECK_SRC_FILES := \
 396         $(call find-other-java-files, $(dirs_to_check_apis)) \
 397         $(common_src_files)
 398
 399 # This is used by ide.mk as the list of source files that are
 400 # always included.
 401 INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
 402
 403 framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
 404         $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
 405
 406 framework_docs_LOCAL_INTERMEDIATE_SOURCES := \
 407                         $(framework_res_source_path)/android/R.java \
 408                         $(framework_res_source_path)/android/Manifest.java \
 409                         $(framework_res_source_path)/com/android/internal/R.java
 410
 411 framework_docs_LOCAL_JAVA_LIBRARIES := \
 412                         bouncycastle \
 413                         core \
 414                         ext \
 415                         framework \
 416                         mms-common \
 417                         telephony-common \
 418                         voip-common \
 419
 420 framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES
 421 framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html
 422 # The since flag (-since N.xml API_LEVEL) is used to add API Level information
 423 # to the reference documentation. Must be in order of oldest to newest.
 424 framework_docs_LOCAL_DROIDDOC_OPTIONS := \
 425     -knowntags ./frameworks/base/docs/knowntags.txt \
 426     -since $(SRC_API_DIR)/1.xml 1 \
 427     -since $(SRC_API_DIR)/2.xml 2 \
 428     -since $(SRC_API_DIR)/3.xml 3 \
 429     -since $(SRC_API_DIR)/4.xml 4 \
 430     -since $(SRC_API_DIR)/5.xml 5 \
 431     -since $(SRC_API_DIR)/6.xml 6 \
 432     -since $(SRC_API_DIR)/7.xml 7 \
 433     -since $(SRC_API_DIR)/8.xml 8 \
 434     -since $(SRC_API_DIR)/9.xml 9 \
 435     -since $(SRC_API_DIR)/10.xml 10 \
 436     -since $(SRC_API_DIR)/11.xml 11 \
 437     -since $(SRC_API_DIR)/12.xml 12 \
 438     -since $(SRC_API_DIR)/13.xml 13 \
 439     -since $(SRC_API_DIR)/14.txt 14 \
 440     -since $(SRC_API_DIR)/15.txt 15 \
 441     -since $(SRC_API_DIR)/16.txt 16 \
 442     -since $(SRC_API_DIR)/17.txt 17 \
 443                 -werror -hide 113 \
 444                 -overview $(LOCAL_PATH)/core/java/overview.html
 445
 446 framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)
 447
 448 framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
 449     frameworks/base/docs/knowntags.txt
 450
 451 sample_dir := development/samples
 452
 453 # the list here should match the list of samples included in the sdk samples package
 454 # (see development/build/sdk.atree)
 455 # remove htmlified samples for now -- samples are still available through the SDK
 456 # web_docs_sample_code_flags := \
 457                 -hdf android.hasSamples 1 \
 458                 -samplecode $(sample_dir)/AccelerometerPlay \
 459                             resources/samples/AccelerometerPlay "Accelerometer Play" \
 460                 -samplecode $(sample_dir)/ActionBarCompat \
 461                             resources/samples/ActionBarCompat "Action Bar Compatibility" \
 462                 -samplecode $(sample_dir)/AndroidBeamDemo \
 463                             resources/samples/AndroidBeamDemo "Android Beam Demo" \
 464                 -samplecode $(sample_dir)/ApiDemos \
 465                             resources/samples/ApiDemos "API Demos" \
 466                 -samplecode $(sample_dir)/Support4Demos \
 467                             resources/samples/Support4Demos "API 4+ Support Demos" \
 468                 -samplecode $(sample_dir)/Support13Demos \
 469                             resources/samples/Support13Demos "API 13+ Support Demos" \
 470                 -samplecode $(sample_dir)/BackupRestore \
 471                             resources/samples/BackupRestore "Backup and Restore" \
 472                 -samplecode $(sample_dir)/BluetoothChat \
 473                             resources/samples/BluetoothChat "Bluetooth Chat" \
 474                 -samplecode $(sample_dir)/BluetoothHDP \
 475                             resources/samples/BluetoothHDP "Bluetooth HDP Demo" \
 476                 -samplecode $(sample_dir)/BusinessCard \
 477                             resources/samples/BusinessCard "Business Card" \
 478                 -samplecode $(sample_dir)/ContactManager \
 479                             resources/samples/ContactManager "Contact Manager" \
 480                 -samplecode $(sample_dir)/CubeLiveWallpaper \
 481                             resources/samples/CubeLiveWallpaper "Cube Live Wallpaper" \
 482                 -samplecode $(sample_dir)/Home \
 483                             resources/samples/Home "Home" \
 484                 -samplecode $(sample_dir)/HoneycombGallery \
 485                             resources/samples/HoneycombGallery "Honeycomb Gallery" \
 486                 -samplecode $(sample_dir)/JetBoy \
 487                             resources/samples/JetBoy "JetBoy" \
 488                 -samplecode $(sample_dir)/KeyChainDemo \
 489                             resources/samples/KeyChainDemo "KeyChain Demo" \
 490                 -samplecode $(sample_dir)/LunarLander \
 491                             resources/samples/LunarLander "Lunar Lander" \
 492                 -samplecode $(sample_dir)/training/ads-and-ux \
 493                             resources/samples/training/ads-and-ux "Mobile Advertisement Integration" \
 494                 -samplecode $(sample_dir)/MultiResolution \
 495                             resources/samples/MultiResolution "Multiple Resolutions" \
 496                 -samplecode $(sample_dir)/training/multiscreen/newsreader \
 497                             resources/samples/newsreader "News Reader" \
 498                 -samplecode $(sample_dir)/NotePad \
 499                             resources/samples/NotePad "Note Pad" \
 500                 -samplecode $(sample_dir)/SpellChecker/SampleSpellCheckerService \
 501                             resources/samples/SpellChecker/SampleSpellCheckerService "Spell Checker Service" \
 502                 -samplecode $(sample_dir)/SpellChecker/HelloSpellChecker \
 503                             resources/samples/SpellChecker/HelloSpellChecker "Spell Checker Client" \
 504                 -samplecode $(sample_dir)/SampleSyncAdapter \
 505                             resources/samples/SampleSyncAdapter "Sample Sync Adapter" \
 506                 -samplecode $(sample_dir)/RandomMusicPlayer \
 507                             resources/samples/RandomMusicPlayer "Random Music Player" \
 508                 -samplecode $(sample_dir)/RenderScript \
 509                             resources/samples/RenderScript "RenderScript" \
 510                 -samplecode $(sample_dir)/SearchableDictionary \
 511                             resources/samples/SearchableDictionary "Searchable Dictionary v2" \
 512                 -samplecode $(sample_dir)/SipDemo \
 513                             resources/samples/SipDemo "SIP Demo" \
 514                 -samplecode $(sample_dir)/Snake \
 515                             resources/samples/Snake "Snake" \
 516                 -samplecode $(sample_dir)/SoftKeyboard \
 517                             resources/samples/SoftKeyboard "Soft Keyboard" \
 518                 -samplecode $(sample_dir)/Spinner  \
 519                             resources/samples/Spinner "Spinner" \
 520                 -samplecode $(sample_dir)/SpinnerTest \
 521                             resources/samples/SpinnerTest "SpinnerTest" \
 522                 -samplecode $(sample_dir)/StackWidget \
 523                             resources/samples/StackWidget "StackView Widget" \
 524                 -samplecode $(sample_dir)/TicTacToeLib  \
 525                             resources/samples/TicTacToeLib "TicTacToeLib" \
 526                 -samplecode $(sample_dir)/TicTacToeMain \
 527                             resources/samples/TicTacToeMain "TicTacToeMain" \
 528                 -samplecode $(sample_dir)/ToyVpn \
 529                             resources/samples/ToyVpn "Toy VPN Client" \
 530                 -samplecode $(sample_dir)/USB \
 531                             resources/samples/USB "USB" \
 532                 -samplecode $(sample_dir)/WeatherListWidget \
 533                             resources/samples/WeatherListWidget "Weather List Widget" \
 534                 -samplecode $(sample_dir)/WiFiDirectDemo \
 535                             resources/samples/WiFiDirectDemo "Wi-Fi Direct Demo" \
 536                 -samplecode $(sample_dir)/Wiktionary \
 537                             resources/samples/Wiktionary "Wiktionary" \
 538                 -samplecode $(sample_dir)/WiktionarySimple \
 539                             resources/samples/WiktionarySimple "Wiktionary (Simplified)" \
 540                 -samplecode $(sample_dir)/VoiceRecognitionService \
 541                             resources/samples/VoiceRecognitionService "Voice Recognition Service" \
 542                 -samplecode $(sample_dir)/VoicemailProviderDemo \
 543                             resources/samples/VoicemailProviderDemo "Voicemail Provider Demo" \
 544                 -samplecode $(sample_dir)/XmlAdapters \
 545                             resources/samples/XmlAdapters "XML Adapters" \
 546                 -samplecode $(sample_dir)/TtsEngine \
 547                             resources/samples/TtsEngine "Text To Speech Engine" \
 548                 -samplecode $(sample_dir)/training/device-management-policy \
 549                             resources/samples/training/device-management-policy "Device Management Policy"
 550
 551
 552 ## SDK version identifiers used in the published docs
 553   # major[.minor] version for current SDK. (full releases only)
 554 framework_docs_SDK_VERSION:=4.2
 555   # release version (ie "Release x")  (full releases only)
 556 framework_docs_SDK_REL_ID:=1
 557
 558 framework_docs_LOCAL_DROIDDOC_OPTIONS += \
 559                 -hdf sdk.version $(framework_docs_SDK_VERSION) \
 560                 -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
 561                 -hdf sdk.preview 0 \
 562
 563 # ====  the api stubs and current.xml ===========================
 564 include $(CLEAR_VARS)
 565
 566 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
 567 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 568 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 569 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 570 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 571 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 572 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 573 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 574
 575 LOCAL_MODULE := api-stubs
 576
 577 LOCAL_DROIDDOC_OPTIONS:=\
 578                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 579                 -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src \
 580                 -api $(INTERNAL_PLATFORM_API_FILE) \
 581                 -nodocs
 582
 583 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 584
 585 LOCAL_UNINSTALLABLE_MODULE := true
 586
 587 include $(BUILD_DROIDDOC)
 588
 589 # $(gen), i.e. framework.aidl, is also needed while building against the current stub.
 590 $(full_target): $(framework_built) $(gen)
 591 $(INTERNAL_PLATFORM_API_FILE): $(full_target)
 592 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
 593
 594 # ====  check javadoc comments but don't generate docs ========
 595 include $(CLEAR_VARS)
 596
 597 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 598 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 599 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 600 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 601 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 602 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 603 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 604 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 605
 606 LOCAL_MODULE := doc-comment-check
 607
 608 LOCAL_DROIDDOC_OPTIONS:=\
 609                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 610                 -parsecomments
 611
 612 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 613
 614 LOCAL_UNINSTALLABLE_MODULE := true
 615
 616 include $(BUILD_DROIDDOC)
 617
 618 # $(gen), i.e. framework.aidl, is also needed while building against the current stub.
 619 $(full_target): $(framework_built) $(gen)
 620
 621 # Run this for checkbuild
 622 .PHONY: checkbuild
 623 checkbuild: doc-comment-check-docs
 624
 625 # ====  static html in the pdk ==================================
 626 include $(CLEAR_VARS)
 627
 628 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 629 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 630 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 631 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 632 LOCAL_DROIDDOC_HTML_DIR:=../../vendor/pdk/data/google/docs
 633 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 634 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 635
 636 LOCAL_MODULE := offline-pdk
 637
 638 LOCAL_DROIDDOC_OPTIONS:=\
 639                 -hdf android.whichdoc offline \
 640                 -hdf android.whichmodule $(LOCAL_MODULE)
 641
 642 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-pdk
 643
 644 include $(BUILD_DROIDDOC)
 645
 646
 647 # ====  static html in the sdk ==================================
 648 include $(CLEAR_VARS)
 649
 650 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 651 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 652 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 653 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 654 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 655 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 656 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 657 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 658
 659 LOCAL_MODULE := offline-sdk
 660
 661 LOCAL_DROIDDOC_OPTIONS:=\
 662                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 663                 $(web_docs_sample_code_flags) \
 664                 -offlinemode \
 665                 -title "Android SDK" \
 666                 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
 667                 -todo $(OUT_DOCS)/$(LOCAL_MODULE)-docs-todo.html \
 668                 -sdkvalues $(OUT_DOCS) \
 669                 -hdf android.whichdoc offline
 670
 671
 672 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 673
 674 include $(BUILD_DROIDDOC)
 675
 676 static_doc_index_redirect := $(out_dir)/index.html
 677 $(static_doc_index_redirect): \
 678         $(LOCAL_PATH)/docs/docs-documentation-redirect.html | $(ACP)
 679         $(hide) mkdir -p $(dir $@)
 680         $(hide) $(ACP) $< $@
 681
 682 $(full_target): $(static_doc_index_redirect)
 683 $(full_target): $(framework_built)
 684
 685 # ==== docs for the web (on the androiddevdocs app engine server) =======================
 686 include $(CLEAR_VARS)
 687
 688 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 689 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 690 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 691 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 692 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 693 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 694 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 695 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 696 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 697
 698 LOCAL_MODULE := online-sdk
 699
 700 LOCAL_DROIDDOC_OPTIONS:= \
 701                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 702                 $(web_docs_sample_code_flags) \
 703                 -toroot / \
 704                 -hdf android.whichdoc online \
 705                 -hdf template.showLanguageMenu true
 706
 707 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 708
 709 include $(BUILD_DROIDDOC)
 710
 711 # ==== docs for the web (on the devsite app engine server) =======================
 712 include $(CLEAR_VARS)
 713 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 714 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 715 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
 716 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
 717 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 718 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 719 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 720 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 721 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 722 # specify a second html input dir and an output path relative to OUT_DIR)
 723 LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
 724
 725 LOCAL_MODULE := ds
 726
 727 LOCAL_DROIDDOC_OPTIONS:= \
 728                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 729                 $(web_docs_sample_code_flags) \
 730                 -devsite \
 731                 -toroot / \
 732                 -hdf android.whichdoc online \
 733                 -hdf devsite true
 734
 735 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 736
 737 include $(BUILD_DROIDDOC)
 738
 739 # ==== docs that have all of the stuff that's @hidden =======================
 740 include $(CLEAR_VARS)
 741
 742 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
 743 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
 744 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) framework
 745 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
 746 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
 747 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
 748 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
 749 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
 750
 751 LOCAL_MODULE := hidden
 752 LOCAL_DROIDDOC_OPTIONS:=\
 753                 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
 754                 -title "Android SDK - Including hidden APIs."
 755 #               -hidden
 756
 757 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
 758
 759 include $(BUILD_DROIDDOC)
 760
 761 # Build ext.jar
 762 # ============================================================
 763
 764 # NOTICE notes for non-obvious sections
 765 # apache-http - covered by the Apache Commons section.
 766
 767
 768 ext_dirs := \
 769         ../../external/nist-sip/java \
 770         ../../external/apache-http/src \
 771         ../../external/tagsoup/src \
 772         ../../external/libphonenumber/java/src
 773
 774 ext_src_files := $(call all-java-files-under,$(ext_dirs))
 775
 776 ext_res_dirs := \
 777         ../../external/libphonenumber/java/src
 778
 779 # ====  the library  =========================================
 780 include $(CLEAR_VARS)
 781
 782 LOCAL_SRC_FILES := $(ext_src_files)
 783
 784 LOCAL_NO_STANDARD_LIBRARIES := true
 785 LOCAL_JAVA_LIBRARIES := core
 786 LOCAL_JAVA_RESOURCE_DIRS := $(ext_res_dirs)
 787 LOCAL_MODULE_TAGS := optional
 788 LOCAL_MODULE := ext
 789
 790 LOCAL_DX_FLAGS := --core-library
 791
 792 include $(BUILD_JAVA_LIBRARY)
 793
 794
 795 # Include subdirectory makefiles
 796 # ============================================================
 797
 798 # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
 799 # team really wants is to build the stuff defined by this makefile.
 800 ifeq (,$(ONE_SHOT_MAKEFILE))
 801 include $(call first-makefiles-under,$(LOCAL_PATH))
 802 endif