Android.mk revision 2f04883ff880966d63d1aa4a1c7b05e497cfcc58
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#
16LOCAL_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.
27framework_res_source_path := APPS/framework-res_intermediates/src
28
29# the library
30# ============================================================
31include $(CLEAR_VARS)
32
33# FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
34LOCAL_SRC_FILES := $(call find-other-java-files,$(FRAMEWORKS_BASE_SUBDIRS))
35
36# EventLogTags files.
37LOCAL_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.
46LOCAL_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.
56ifeq ($(TARGET_BUILD_TYPE),debug)
57  LOCAL_SRC_FILES += $(call find-other-java-files,core/config/debug)
58else
59  LOCAL_SRC_FILES += $(call find-other-java-files,core/config/ndebug)
60endif
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: ########################################################
72LOCAL_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
202LOCAL_AIDL_INCLUDES += $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
203
204LOCAL_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
209LOCAL_NO_STANDARD_LIBRARIES := true
210LOCAL_JAVA_LIBRARIES := bouncycastle core core-junit ext
211
212LOCAL_MODULE := framework
213LOCAL_MODULE_CLASS := JAVA_LIBRARIES
214
215LOCAL_NO_EMMA_INSTRUMENT := true
216LOCAL_NO_EMMA_COMPILE := true
217
218# List of classes and interfaces which should be loaded by the Zygote.
219LOCAL_JAVA_RESOURCE_FILES += $(LOCAL_PATH)/preloaded-classes
220
221#LOCAL_JARJAR_RULES := $(LOCAL_PATH)/jarjar-rules.txt
222
223LOCAL_DX_FLAGS := --core-library
224
225include $(BUILD_JAVA_LIBRARY)
226
227# Make sure that R.java and Manifest.java are built before we build
228# the source for this library.
229framework_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
236framework_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# ============================================================
241aidl_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
285gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
286$(gen): PRIVATE_SRC_FILES := $(aidl_files)
287ALL_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
296packages_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.
302fwbase_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.
315fwbase_dirs_to_document += core/config/sdk
316
317# include definition of libcore_to_document
318# These are relative to libcore
319include $(LOCAL_PATH)/../../libcore/Docs.mk
320
321non_base_dirs := \
322	../../external/apache-http/src/org/apache/http
323
324# These are relative to frameworks/base
325dirs_to_document := \
326	$(fwbase_dirs_to_document) \
327	$(non_base_dirs) \
328	$(addprefix ../../libcore/, $(libcore_to_document))
329
330html_dirs := \
331	$(FRAMEWORKS_BASE_SUBDIRS) \
332	$(non_base_dirs)
333
334# These are relative to frameworks/base
335framework_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.
341INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
342
343framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
344	$(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
345
346framework_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
351framework_docs_LOCAL_JAVA_LIBRARIES := \
352			bouncycastle \
353			core \
354			ext \
355			framework \
356
357framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES
358framework_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.
361framework_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		-werror -hide 113 \
376		-overview $(LOCAL_PATH)/core/java/overview.html
377
378framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= $(call intermediates-dir-for,JAVA_LIBRARIES,framework)
379
380framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
381    frameworks/base/docs/knowntags.txt
382
383sample_dir := development/samples
384
385# the list here should match the list of samples included in the sdk samples package
386# (see development/build/sdk.atree)
387web_docs_sample_code_flags := \
388		-hdf android.hasSamples 1 \
389		-samplecode $(sample_dir)/AccessibilityService \
390		            resources/samples/AccessibilityService "Accessibility Service" \
391		-samplecode $(sample_dir)/AccelerometerPlay \
392		            resources/samples/AccelerometerPlay "Accelerometer Play" \
393		-samplecode $(sample_dir)/ApiDemos \
394		            resources/samples/ApiDemos "API Demos" \
395		-samplecode $(sample_dir)/Support4Demos \
396		            resources/samples/Support4Demos "API 4+ Support Demos" \
397		-samplecode $(sample_dir)/Support13Demos \
398		            resources/samples/Support13Demos "API 13+ Support Demos" \
399		-samplecode $(sample_dir)/BackupRestore \
400		            resources/samples/BackupRestore "Backup and Restore" \
401		-samplecode $(sample_dir)/BluetoothChat \
402		            resources/samples/BluetoothChat "Bluetooth Chat" \
403		-samplecode $(sample_dir)/BusinessCard \
404		            resources/samples/BusinessCard "Business Card" \
405		-samplecode $(sample_dir)/ContactManager \
406		            resources/samples/ContactManager "Contact Manager" \
407    -samplecode $(sample_dir)/CubeLiveWallpaper \
408                resources/samples/CubeLiveWallpaper "Cube Live Wallpaper" \
409		-samplecode $(sample_dir)/Home \
410		            resources/samples/Home "Home" \
411                -samplecode $(sample_dir)/HoneycombGallery \
412                            resources/samples/HoneycombGallery "Honeycomb Gallery" \
413		-samplecode $(sample_dir)/JetBoy \
414		            resources/samples/JetBoy "JetBoy" \
415		-samplecode $(sample_dir)/LunarLander \
416		            resources/samples/LunarLander "Lunar Lander" \
417		-samplecode $(sample_dir)/MultiResolution \
418		            resources/samples/MultiResolution "Multiple Resolutions" \
419		-samplecode $(sample_dir)/NFCDemo \
420		            resources/samples/NFCDemo "NFC Demo" \
421		-samplecode $(sample_dir)/NotePad \
422		            resources/samples/NotePad "Note Pad" \
423		-samplecode $(sample_dir)/SampleSyncAdapter \
424		            resources/samples/SampleSyncAdapter "Sample Sync Adapter" \
425		-samplecode $(sample_dir)/RenderScript \
426		            resources/samples/RenderScript "RenderScript" \
427		-samplecode $(sample_dir)/SearchableDictionary \
428		            resources/samples/SearchableDictionary "Searchable Dictionary v2" \
429		-samplecode $(sample_dir)/SipDemo \
430		            resources/samples/SipDemo "SIP Demo" \
431		-samplecode $(sample_dir)/Snake \
432		            resources/samples/Snake "Snake" \
433		-samplecode $(sample_dir)/SoftKeyboard \
434		            resources/samples/SoftKeyboard "Soft Keyboard" \
435		-samplecode $(sample_dir)/Spinner  \
436		            resources/samples/Spinner "Spinner" \
437		-samplecode $(sample_dir)/SpinnerTest \
438		            resources/samples/SpinnerTest "SpinnerTest" \
439		-samplecode $(sample_dir)/StackWidget \
440		            resources/samples/StackWidget "StackView Widget" \
441		-samplecode $(sample_dir)/TicTacToeLib  \
442		            resources/samples/TicTacToeLib "TicTacToeLib" \
443		-samplecode $(sample_dir)/TicTacToeMain \
444		            resources/samples/TicTacToeMain "TicTacToeMain" \
445		-samplecode $(sample_dir)/USB \
446		            resources/samples/USB "USB" \
447		-samplecode $(sample_dir)/WeatherListWidget \
448		            resources/samples/WeatherListWidget "Weather List Widget" \
449		-samplecode $(sample_dir)/Wiktionary \
450		            resources/samples/Wiktionary "Wiktionary" \
451		-samplecode $(sample_dir)/WiktionarySimple \
452		            resources/samples/WiktionarySimple "Wiktionary (Simplified)" \
453		-samplecode $(sample_dir)/VoiceRecognitionService \
454		            resources/samples/VoiceRecognitionService "Voice Recognition Service" \
455		-samplecode $(sample_dir)/XmlAdapters \
456		            resources/samples/XmlAdapters "XML Adapters"
457
458## SDK version identifiers used in the published docs
459  # major[.minor] version for current SDK. (full releases only)
460framework_docs_SDK_VERSION:=3.1
461  # release version (ie "Release x")  (full releases only)
462framework_docs_SDK_REL_ID:=1
463
464framework_docs_LOCAL_DROIDDOC_OPTIONS += \
465		-hdf sdk.version $(framework_docs_SDK_VERSION) \
466		-hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
467		-hdf sdk.preview 0 \
468
469# ====  the api stubs and current.xml ===========================
470include $(CLEAR_VARS)
471
472LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
473LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
474LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
475LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
476LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
477LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
478LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
479LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
480
481LOCAL_MODULE := api-stubs
482
483LOCAL_DROIDDOC_OPTIONS:=\
484		$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
485		-stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src \
486		-apixml $(INTERNAL_PLATFORM_API_FILE) \
487		-nodocs
488
489LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
490
491LOCAL_UNINSTALLABLE_MODULE := true
492
493include $(BUILD_DROIDDOC)
494
495# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
496$(full_target): $(framework_built) $(gen)
497$(INTERNAL_PLATFORM_API_FILE): $(full_target)
498$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
499
500# ====  check javadoc comments but don't generate docs ========
501include $(CLEAR_VARS)
502
503LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
504LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
505LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
506LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
507LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
508LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
509LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
510LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
511
512LOCAL_MODULE := doc-comment-check
513
514LOCAL_DROIDDOC_OPTIONS:=\
515		$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
516		-parsecomments
517
518LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
519
520LOCAL_UNINSTALLABLE_MODULE := true
521
522include $(BUILD_DROIDDOC)
523
524# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
525$(full_target): $(framework_built) $(gen)
526
527droidcore: doc-comment-check-docs
528
529# ====  static html in the sdk ==================================
530include $(CLEAR_VARS)
531
532LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
533LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
534LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
535LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
536LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
537LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
538LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
539LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
540
541LOCAL_MODULE := offline-sdk
542
543LOCAL_DROIDDOC_OPTIONS:=\
544		$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
545                $(web_docs_sample_code_flags) \
546                -offlinemode \
547		-title "Android SDK" \
548		-proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
549		-todo $(OUT_DOCS)/$(LOCAL_MODULE)-docs-todo.html \
550		-sdkvalues $(OUT_DOCS) \
551		-hdf android.whichdoc offline
552
553
554LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
555
556include $(BUILD_DROIDDOC)
557
558static_doc_index_redirect := $(out_dir)/index.html
559$(static_doc_index_redirect): \
560	$(LOCAL_PATH)/docs/docs-documentation-redirect.html | $(ACP)
561	$(hide) mkdir -p $(dir $@)
562	$(hide) $(ACP) $< $@
563
564$(full_target): $(static_doc_index_redirect)
565$(full_target): $(framework_built)
566
567# ==== docs for the web (on the google app engine server) =======================
568include $(CLEAR_VARS)
569
570LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
571LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
572LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
573LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
574LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
575LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
576LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
577LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
578LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
579
580LOCAL_MODULE := online-sdk
581
582LOCAL_DROIDDOC_OPTIONS:= \
583		$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
584		$(web_docs_sample_code_flags) \
585		-toroot / \
586		-hdf android.whichdoc online \
587		-hdf template.showLanguageMenu true
588
589LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
590
591include $(BUILD_DROIDDOC)
592
593# explicitly specify that online-sdk depends on framework-res and any generated docs
594$(full_target): framework-res-package-target
595
596# ==== docs that have all of the stuff that's @hidden =======================
597include $(CLEAR_VARS)
598
599LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
600LOCAL_INTERMEDIATE_SOURCES:=$(framework_docs_LOCAL_INTERMEDIATE_SOURCES)
601LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES) framework
602LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
603LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
604LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
605LOCAL_ADDITIONAL_JAVA_DIR:=$(call intermediates-dir-for,JAVA_LIBRARIES,framework)
606LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
607
608LOCAL_MODULE := hidden
609LOCAL_DROIDDOC_OPTIONS:=\
610		$(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
611		-title "Android SDK - Including hidden APIs."
612#		-hidden
613
614LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk
615
616include $(BUILD_DROIDDOC)
617
618# Build ext.jar
619# ============================================================
620
621# NOTICE notes for non-obvious sections
622# apache-http - covered by the Apache Commons section.
623
624
625ext_dirs := \
626	../../external/nist-sip/java \
627	../../external/apache-http/src \
628	../../external/tagsoup/src \
629	../../external/libphonenumber/java/src
630
631ext_src_files := $(call all-java-files-under,$(ext_dirs))
632
633ext_res_dirs := \
634	../../external/libphonenumber/java/src
635
636# ====  the library  =========================================
637include $(CLEAR_VARS)
638
639LOCAL_SRC_FILES := $(ext_src_files)
640
641LOCAL_NO_STANDARD_LIBRARIES := true
642LOCAL_JAVA_LIBRARIES := core
643LOCAL_JAVA_RESOURCE_DIRS := $(ext_res_dirs)
644LOCAL_MODULE_TAGS := optional
645LOCAL_MODULE := ext
646
647LOCAL_NO_EMMA_INSTRUMENT := true
648LOCAL_NO_EMMA_COMPILE := true
649
650include $(BUILD_JAVA_LIBRARY)
651
652
653# Include subdirectory makefiles
654# ============================================================
655
656# If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
657# team really wants is to build the stuff defined by this makefile.
658ifeq (,$(ONE_SHOT_MAKEFILE))
659include $(call first-makefiles-under,$(LOCAL_PATH))
660endif
661