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