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