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/IContentService.aidl \ 104 core/java/android/content/IIntentReceiver.aidl \ 105 core/java/android/content/IIntentSender.aidl \ 106 core/java/android/content/ISyncAdapter.aidl \ 107 core/java/android/content/ISyncContext.aidl \ 108 core/java/android/content/ISyncStatusObserver.aidl \ 109 core/java/android/content/pm/IPackageDataObserver.aidl \ 110 core/java/android/content/pm/IPackageDeleteObserver.aidl \ 111 core/java/android/content/pm/IPackageInstallObserver.aidl \ 112 core/java/android/content/pm/IPackageManager.aidl \ 113 core/java/android/content/pm/IPackageMoveObserver.aidl \ 114 core/java/android/content/pm/IPackageStatsObserver.aidl \ 115 core/java/android/database/IContentObserver.aidl \ 116 core/java/android/net/IConnectivityManager.aidl \ 117 core/java/android/net/INetworkManagementEventObserver.aidl \ 118 core/java/android/net/IThrottleManager.aidl \ 119 core/java/android/nfc/ILlcpConnectionlessSocket.aidl \ 120 core/java/android/nfc/ILlcpServiceSocket.aidl \ 121 core/java/android/nfc/ILlcpSocket.aidl \ 122 core/java/android/nfc/INdefTag.aidl \ 123 core/java/android/nfc/INfcAdapter.aidl \ 124 core/java/android/nfc/INfcTag.aidl \ 125 core/java/android/nfc/IP2pInitiator.aidl \ 126 core/java/android/nfc/IP2pTarget.aidl \ 127 core/java/android/os/IHardwareService.aidl \ 128 core/java/android/os/IMessenger.aidl \ 129 core/java/android/os/INetworkManagementService.aidl \ 130 core/java/android/os/INetStatService.aidl \ 131 core/java/android/os/IPermissionController.aidl \ 132 core/java/android/os/IPowerManager.aidl \ 133 core/java/android/os/IRemoteCallback.aidl \ 134 core/java/android/os/IVibratorService.aidl \ 135 core/java/android/service/urlrenderer/IUrlRendererService.aidl \ 136 core/java/android/service/urlrenderer/IUrlRendererCallback.aidl \ 137 core/java/android/service/wallpaper/IWallpaperConnection.aidl \ 138 core/java/android/service/wallpaper/IWallpaperEngine.aidl \ 139 core/java/android/service/wallpaper/IWallpaperService.aidl \ 140 core/java/android/text/IClipboard.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 location/java/android/location/IGeocodeProvider.aidl \ 171 location/java/android/location/IGpsStatusListener.aidl \ 172 location/java/android/location/IGpsStatusProvider.aidl \ 173 location/java/android/location/ILocationListener.aidl \ 174 location/java/android/location/ILocationManager.aidl \ 175 location/java/android/location/ILocationProvider.aidl \ 176 location/java/android/location/INetInitiatedListener.aidl \ 177 media/java/android/media/IAudioService.aidl \ 178 media/java/android/media/IAudioFocusDispatcher.aidl \ 179 media/java/android/media/IMediaScannerListener.aidl \ 180 media/java/android/media/IMediaScannerService.aidl \ 181 telephony/java/com/android/internal/telephony/IPhoneStateListener.aidl \ 182 telephony/java/com/android/internal/telephony/IPhoneSubInfo.aidl \ 183 telephony/java/com/android/internal/telephony/ITelephony.aidl \ 184 telephony/java/com/android/internal/telephony/ITelephonyRegistry.aidl \ 185 telephony/java/com/android/internal/telephony/IIccPhoneBook.aidl \ 186 telephony/java/com/android/internal/telephony/ISms.aidl \ 187 wifi/java/android/net/wifi/IWifiManager.aidl \ 188 telephony/java/com/android/internal/telephony/IExtendedNetworkService.aidl \ 189 vpn/java/android/net/vpn/IVpnService.aidl \ 190 voip/java/android/net/sip/ISipSession.aidl \ 191 voip/java/android/net/sip/ISipSessionListener.aidl \ 192 voip/java/android/net/sip/ISipService.aidl 193 # 194 195 196 # FRAMEWORKS_BASE_JAVA_SRC_DIRS comes from build/core/pathmap.mk 197 LOCAL_AIDL_INCLUDES += $(FRAMEWORKS_BASE_JAVA_SRC_DIRS) 198 199 LOCAL_INTERMEDIATE_SOURCES := \ 200 $(framework_res_source_path)/android/R.java \ 201 $(framework_res_source_path)/android/Manifest.java \ 202 $(framework_res_source_path)/com/android/internal/R.java 203 204 LOCAL_NO_STANDARD_LIBRARIES := true 205 LOCAL_JAVA_LIBRARIES := bouncycastle core core-junit ext 206 207 LOCAL_MODULE := framework 208 LOCAL_MODULE_CLASS := JAVA_LIBRARIES 209 210 LOCAL_NO_EMMA_INSTRUMENT := true 211 LOCAL_NO_EMMA_COMPILE := true 212 213 # List of classes and interfaces which should be loaded by the Zygote. 214 LOCAL_JAVA_RESOURCE_FILES += $(LOCAL_PATH)/preloaded-classes 215 216 #LOCAL_JARJAR_RULES := $(LOCAL_PATH)/jarjar-rules.txt 217 218 LOCAL_DX_FLAGS := --core-library 219 220 include $(BUILD_JAVA_LIBRARY) 221 222 # Make sure that R.java and Manifest.java are built before we build 223 # the source for this library. 224 framework_res_R_stamp := \ 225 $(call intermediates-dir-for,APPS,framework-res,,COMMON)/src/R.stamp 226 $(full_classes_compiled_jar): $(framework_res_R_stamp) 227 228 # Make sure that framework-res is installed when framework is. 229 $(LOCAL_INSTALLED_MODULE): | $(dir $(LOCAL_INSTALLED_MODULE))framework-res.apk 230 231 framework_built := $(LOCAL_BUILT_MODULE) 232 233 # AIDL files to be preprocessed and included in the SDK, 234 # relative to the root of the build tree. 235 # ============================================================ 236 aidl_files := \ 237 frameworks/base/core/java/android/accounts/IAccountManager.aidl \ 238 frameworks/base/core/java/android/accounts/IAccountManagerResponse.aidl \ 239 frameworks/base/core/java/android/accounts/IAccountAuthenticator.aidl \ 240 frameworks/base/core/java/android/accounts/IAccountAuthenticatorResponse.aidl \ 241 frameworks/base/core/java/android/app/Notification.aidl \ 242 frameworks/base/core/java/android/app/PendingIntent.aidl \ 243 frameworks/base/core/java/android/bluetooth/BluetoothDevice.aidl \ 244 frameworks/base/core/java/android/content/ComponentName.aidl \ 245 frameworks/base/core/java/android/content/Intent.aidl \ 246 frameworks/base/core/java/android/content/IntentSender.aidl \ 247 frameworks/base/core/java/android/content/PeriodicSync.aidl \ 248 frameworks/base/core/java/android/content/SyncStats.aidl \ 249 frameworks/base/core/java/android/content/res/Configuration.aidl \ 250 frameworks/base/core/java/android/appwidget/AppWidgetProviderInfo.aidl \ 251 frameworks/base/core/java/android/net/Uri.aidl \ 252 frameworks/base/core/java/android/nfc/NdefMessage.aidl \ 253 frameworks/base/core/java/android/nfc/NdefRecord.aidl \ 254 frameworks/base/core/java/android/nfc/Tag.aidl \ 255 frameworks/base/core/java/android/nfc/NdefTag.aidl \ 256 frameworks/base/core/java/android/os/Bundle.aidl \ 257 frameworks/base/core/java/android/os/DropBoxManager.aidl \ 258 frameworks/base/core/java/android/os/ParcelFileDescriptor.aidl \ 259 frameworks/base/core/java/android/os/ParcelUuid.aidl \ 260 frameworks/base/core/java/android/view/KeyEvent.aidl \ 261 frameworks/base/core/java/android/view/MotionEvent.aidl \ 262 frameworks/base/core/java/android/view/Surface.aidl \ 263 frameworks/base/core/java/android/view/WindowManager.aidl \ 264 frameworks/base/core/java/android/widget/RemoteViews.aidl \ 265 frameworks/base/core/java/com/android/internal/view/IInputContext.aidl \ 266 frameworks/base/core/java/com/android/internal/view/IInputMethod.aidl \ 267 frameworks/base/core/java/com/android/internal/view/IInputMethodCallback.aidl \ 268 frameworks/base/core/java/com/android/internal/view/IInputMethodClient.aidl \ 269 frameworks/base/core/java/com/android/internal/view/IInputMethodManager.aidl \ 270 frameworks/base/core/java/com/android/internal/view/IInputMethodSession.aidl \ 271 frameworks/base/graphics/java/android/graphics/Bitmap.aidl \ 272 frameworks/base/graphics/java/android/graphics/Rect.aidl \ 273 frameworks/base/graphics/java/android/graphics/Region.aidl \ 274 frameworks/base/location/java/android/location/Criteria.aidl \ 275 frameworks/base/location/java/android/location/Location.aidl \ 276 frameworks/base/telephony/java/android/telephony/ServiceState.aidl \ 277 frameworks/base/telephony/java/com/android/internal/telephony/IPhoneSubInfo.aidl \ 278 frameworks/base/telephony/java/com/android/internal/telephony/ITelephony.aidl \ 279 frameworks/base/vpn/java/android/net/vpn/IVpnService.aidl \ 280 281 gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl 282 $(gen): PRIVATE_SRC_FILES := $(aidl_files) 283 ALL_SDK_FILES += $(gen) 284 $(gen): $(aidl_files) | $(AIDL) 285 @echo Aidl Preprocess: $@ 286 $(hide) $(AIDL) --preprocess $@ $(PRIVATE_SRC_FILES) 287 288 # the documentation 289 # ============================================================ 290 291 # TODO: deal with com/google/android/googleapps 292 packages_to_document := \ 293 android \ 294 javax/microedition/khronos 295 296 # Search through the base framework dirs for these packages. 297 # The result will be relative to frameworks/base. 298 fwbase_dirs_to_document := \ 299 test-runner/src \ 300 $(patsubst $(LOCAL_PATH)/%,%, \ 301 $(wildcard \ 302 $(foreach dir, $(FRAMEWORKS_BASE_JAVA_SRC_DIRS), \ 303 $(addprefix $(dir)/, $(packages_to_document)) \ 304 ) \ 305 ) \ 306 ) 307 308 # Pass a special "fake-out" version of some classes to the doc/API tools. 309 # ConfigBuildFlags uses this trick to prevent certain fields from appearing 310 # as "final" in the official SDK APIs. 311 fwbase_dirs_to_document += core/config/sdk 312 313 # These are relative to libcore 314 # Intentionally not included from libcore: 315 # icu openssl suncompat support 316 libcore_to_document := \ 317 dalvik/src/main/java/dalvik \ 318 json/src/main/java \ 319 junit/src/main/java \ 320 luni/src/main/java/java \ 321 luni/src/main/java/javax \ 322 luni/src/main/java/org/xml/sax \ 323 luni/src/main/java/org/w3c \ 324 xml/src/main/java/org/xmlpull/v1 \ 325 326 non_base_dirs := \ 327 ../../external/apache-http/src/org/apache/http 328 329 # These are relative to frameworks/base 330 dirs_to_document := \ 331 $(fwbase_dirs_to_document) \ 332 $(non_base_dirs) \ 333 $(addprefix ../../libcore/, $(libcore_to_document)) 334 335 html_dirs := \ 336 $(FRAMEWORKS_BASE_SUBDIRS) \ 337 $(non_base_dirs) 338 339 # These are relative to frameworks/base 340 framework_docs_LOCAL_SRC_FILES := \ 341 $(call find-other-java-files, $(dirs_to_document)) \ 342 $(call find-other-html-files, $(html_dirs)) 343 344 # This is used by ide.mk as the list of source files that are 345 # always included. 346 INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document)) 347 348 framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \ 349 $(FRAMEWORKS_BASE_JAVA_SRC_DIRS) 350 351 framework_docs_LOCAL_INTERMEDIATE_SOURCES := \ 352 $(framework_res_source_path)/android/R.java \ 353 $(framework_res_source_path)/android/Manifest.java \ 354 $(framework_res_source_path)/com/android/internal/R.java 355 356 framework_docs_LOCAL_JAVA_LIBRARIES := \ 357 bouncycastle \ 358 core \ 359 ext \ 360 framework \ 361 362 framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES 363 framework_docs_LOCAL_DROIDDOC_HTML_DIR := $(LOCAL_PATH)/docs/html $(OUT_DOCS)/gen 364 # The since flag (-since N.xml API_LEVEL) is used to add API Level information 365 # to the reference documentation. Must be in order of oldest to newest. 366 framework_docs_LOCAL_DROIDDOC_OPTIONS := \ 367 -knowntags ./frameworks/base/docs/knowntags.txt \ 368 -since ./frameworks/base/api/1.xml 1 \ 369 -since ./frameworks/base/api/2.xml 2 \ 370 -since ./frameworks/base/api/3.xml 3 \ 371 -since ./frameworks/base/api/4.xml 4 \ 372 -since ./frameworks/base/api/5.xml 5 \ 373 -since ./frameworks/base/api/6.xml 6 \ 374 -since ./frameworks/base/api/7.xml 7 \ 375 -since ./frameworks/base/api/8.xml 8 \ 376 -since ./frameworks/base/api/9.xml 9 \ 377 -werror -hide 13 \ 378 -overview $(LOCAL_PATH)/core/java/overview.html 379 380 framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= $(call intermediates-dir-for,JAVA_LIBRARIES,framework) 381 382 framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \ 383 frameworks/base/docs/knowntags.txt 384 385 sample_dir := development/samples 386 387 # the list here should match the list of samples included in the sdk samples package 388 # (see development/build/sdk.atree) 389 web_docs_sample_code_flags := \ 390 -hdf android.hasSamples 1 \ 391 -samplecode $(sample_dir)/ApiDemos \ 392 resources/samples/ApiDemos "API Demos" \ 393 -samplecode $(sample_dir)/BackupRestore \ 394 resources/samples/BackupRestore "Backup and Restore" \ 395 -samplecode $(sample_dir)/BluetoothChat \ 396 resources/samples/BluetoothChat "Bluetooth Chat" \ 397 -samplecode $(sample_dir)/BusinessCard \ 398 resources/samples/BusinessCard "Business Card" \ 399 -samplecode $(sample_dir)/ContactManager \ 400 resources/samples/ContactManager "Contact Manager" \ 401 -samplecode $(sample_dir)/CubeLiveWallpaper \ 402 resources/samples/CubeLiveWallpaper "Live Wallpaper" \ 403 -samplecode $(sample_dir)/Home \ 404 resources/samples/Home "Home" \ 405 -samplecode $(sample_dir)/HeavyWeight \ 406 resources/samples/HeavyWeight "Heavy Weight App" \ 407 -samplecode $(sample_dir)/JetBoy \ 408 resources/samples/JetBoy "JetBoy" \ 409 -samplecode $(sample_dir)/LunarLander \ 410 resources/samples/LunarLander "Lunar Lander" \ 411 -samplecode $(sample_dir)/MultiResolution \ 412 resources/samples/MultiResolution "Multiple Resolutions" \ 413 -samplecode $(sample_dir)/NotePad \ 414 resources/samples/NotePad "Note Pad" \ 415 -samplecode $(sample_dir)/SampleSyncAdapter \ 416 resources/samples/SampleSyncAdapter "Sample Sync Adapter" \ 417 -samplecode $(sample_dir)/SearchableDictionary \ 418 resources/samples/SearchableDictionary "Searchable Dictionary v2" \ 419 -samplecode $(sample_dir)/SipDemo \ 420 resources/samples/SipDemo "SIP Demo" \ 421 -samplecode $(sample_dir)/Snake \ 422 resources/samples/Snake "Snake" \ 423 -samplecode $(sample_dir)/SoftKeyboard \ 424 resources/samples/SoftKeyboard "Soft Keyboard" \ 425 -samplecode $(sample_dir)/Spinner \ 426 resources/samples/Spinner "Spinner" \ 427 -samplecode $(sample_dir)/SpinnerTest \ 428 resources/samples/SpinnerTest "SpinnerTest" \ 429 -samplecode $(sample_dir)/TicTacToeLib \ 430 resources/samples/TicTacToeLib "TicTacToeLib" \ 431 -samplecode $(sample_dir)/TicTacToeMain \ 432 resources/samples/TicTacToeMain "TicTacToeMain" \ 433 -samplecode $(sample_dir)/Wiktionary \ 434 resources/samples/Wiktionary "Wiktionary" \ 435 -samplecode $(sample_dir)/WiktionarySimple \ 436 resources/samples/WiktionarySimple "Wiktionary (Simplified)" \ 437 -samplecode $(sample_dir)/VoiceRecognitionService \ 438 resources/samples/VoiceRecognitionService "Voice Recognition Service" \ 439 -samplecode $(sample_dir)/NFCDemo \ 440 resources/samples/NFCDemo "NFC Demo" 441 442 ## SDK version identifiers used in the published docs 443 # major[.minor] version for current SDK. (full releases only) 444 framework_docs_SDK_VERSION:=2.2 445 # release version (ie "Release x") (full releases only) 446 framework_docs_SDK_REL_ID:=1 447 # flag to build offline docs for a preview release 448 framework_docs_SDK_PREVIEW:=0 449 450 framework_docs_LOCAL_DROIDDOC_OPTIONS += \ 451 -hdf sdk.version $(framework_docs_SDK_VERSION) \ 452 -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) 453 454 # ==== the api stubs and current.xml =========================== 455 include $(CLEAR_VARS) 456 457 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) 458 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES) 459 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) 460 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) 461 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) 462 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) 463 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) 464 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) 465 466 LOCAL_MODULE := api-stubs 467 468 LOCAL_DROIDDOC_OPTIONS:=\ 469 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ 470 -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src \ 471 -apixml $(INTERNAL_PLATFORM_API_FILE) \ 472 -nodocs 473 474 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk 475 LOCAL_DROIDDOC_CUSTOM_ASSET_DIR:=assets-sdk 476 477 include $(BUILD_DROIDDOC) 478 479 $(full_target): $(framework_built) 480 $(INTERNAL_PLATFORM_API_FILE): $(full_target) 481 $(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE)) 482 483 # ==== check javadoc comments but don't generate docs ======== 484 include $(CLEAR_VARS) 485 486 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) 487 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES) 488 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) 489 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) 490 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) 491 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) 492 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) 493 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) 494 495 LOCAL_MODULE := doc-comment-check 496 497 LOCAL_DROIDDOC_OPTIONS:=\ 498 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ 499 -parsecomments 500 501 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk 502 LOCAL_DROIDDOC_CUSTOM_ASSET_DIR:=assets-sdk 503 504 include $(BUILD_DROIDDOC) 505 506 # $(gen), i.e. framework.aidl, is also needed while building against the current stub. 507 $(full_target): $(framework_built) $(gen) 508 509 droidcore: doc-comment-check-docs 510 511 # ==== static html in the sdk ================================== 512 include $(CLEAR_VARS) 513 514 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) 515 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES) 516 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) 517 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) 518 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) 519 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) 520 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) 521 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) 522 523 LOCAL_MODULE := offline-sdk 524 525 LOCAL_DROIDDOC_OPTIONS:=\ 526 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ 527 $(web_docs_sample_code_flags) \ 528 -offlinemode \ 529 -title "Android SDK" \ 530 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \ 531 -todo $(OUT_DOCS)/$(LOCAL_MODULE)-docs-todo.html \ 532 -sdkvalues $(OUT_DOCS) \ 533 -hdf android.whichdoc offline 534 535 ifeq ($(framework_docs_SDK_PREVIEW),true) 536 LOCAL_DROIDDOC_OPTIONS += -hdf sdk.preview true 537 endif 538 539 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk 540 LOCAL_DROIDDOC_CUSTOM_ASSET_DIR:=assets-sdk 541 542 include $(BUILD_DROIDDOC) 543 544 static_doc_index_redirect := $(out_dir)/index.html 545 $(static_doc_index_redirect): \ 546 $(LOCAL_PATH)/docs/docs-documentation-redirect.html | $(ACP) 547 $(hide) mkdir -p $(dir $@) 548 $(hide) $(ACP) $< $@ 549 550 $(full_target): $(static_doc_index_redirect) 551 $(full_target): $(framework_built) 552 553 554 # ==== docs for the web (on the google app engine server) ======================= 555 include $(CLEAR_VARS) 556 557 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) 558 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES) 559 LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES) 560 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) 561 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) 562 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) 563 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) 564 LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR) 565 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) 566 567 LOCAL_MODULE := online-sdk 568 569 LOCAL_DROIDDOC_OPTIONS:= \ 570 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ 571 $(web_docs_sample_code_flags) \ 572 -toroot / \ 573 -hdf android.whichdoc online \ 574 -hdf template.showLanguageMenu true 575 576 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk 577 LOCAL_DROIDDOC_CUSTOM_ASSET_DIR:=assets-sdk 578 579 include $(BUILD_DROIDDOC) 580 581 # explicitly specify that online-sdk depends on framework-res and any generated docs 582 $(full_target): framework-res-package-target $(ALL_GENERATED_DOCS) 583 584 # ==== docs that have all of the stuff that's @hidden ======================= 585 include $(CLEAR_VARS) 586 587 LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES) 588 LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES) 589 LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) framework 590 LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS) 591 LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH) 592 LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR) 593 LOCAL_ADDITIONAL_JAVA_DIR:=$(call intermediates-dir-for,JAVA_LIBRARIES,framework) 594 LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES) 595 596 LOCAL_MODULE := hidden 597 LOCAL_DROIDDOC_OPTIONS:=\ 598 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \ 599 -title "Android SDK - Including hidden APIs." 600 # -hidden 601 602 LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk 603 LOCAL_DROIDDOC_CUSTOM_ASSET_DIR:=assets-sdk 604 605 include $(BUILD_DROIDDOC) 606 607 # Build ext.jar 608 # ============================================================ 609 610 ext_dirs := \ 611 ../../external/nist-sip/java \ 612 ../../external/apache-http/src \ 613 ../../external/tagsoup/src 614 615 ext_src_files := $(call all-java-files-under,$(ext_dirs)) 616 617 # ==== the library ========================================= 618 include $(CLEAR_VARS) 619 620 LOCAL_SRC_FILES := $(ext_src_files) 621 622 LOCAL_NO_STANDARD_LIBRARIES := true 623 LOCAL_JAVA_LIBRARIES := core 624 LOCAL_MODULE_TAGS := optional 625 LOCAL_MODULE := ext 626 627 LOCAL_NO_EMMA_INSTRUMENT := true 628 LOCAL_NO_EMMA_COMPILE := true 629 630 include $(BUILD_JAVA_LIBRARY) 631 632 633 # Include subdirectory makefiles 634 # ============================================================ 635 636 # If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework 637 # team really wants is to build the stuff defined by this makefile. 638 ifeq (,$(ONE_SHOT_MAKEFILE)) 639 include $(call first-makefiles-under,$(LOCAL_PATH)) 640 endif 641