blob: 6b137086918ad567fd1057438b1cd0bb19b9ed57 [file] [log] [blame]
Bart Searsa8cc0582015-05-07 03:23:20 +00001#
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
Colin Cross5f4dcf62017-11-16 00:15:28 -080018# Load framework-specific path mappings used later in the build.
19include $(LOCAL_PATH)/pathmap.mk
Bart Searsa8cc0582015-05-07 03:23:20 +000020
21# Build the master framework library.
22# The framework contains too many method references (>64K) for poor old DEX.
23# So we first build the framework as a monolithic static library then split it
24# up into smaller pieces.
25# ============================================================
26
27# embedded builds use nothing in frameworks/base
28ifneq ($(ANDROID_BUILD_EMBEDDED),true)
29
Bart Searsa8cc0582015-05-07 03:23:20 +000030# Copy AIDL files to be preprocessed and included in the SDK,
31# specified relative to the root of the build tree.
32# ============================================================
33include $(CLEAR_VARS)
34
35aidl_files := \
Robert Greenwalt4dded7a2016-12-05 16:33:32 -080036 frameworks/base/telephony/java/android/telephony/mbms/DownloadRequest.aidl \
Robert Greenwalt4dded7a2016-12-05 16:33:32 -080037 frameworks/base/telephony/java/android/telephony/mbms/FileInfo.aidl \
38 frameworks/base/telephony/java/android/telephony/mbms/FileServiceInfo.aidl \
39 frameworks/base/telephony/java/android/telephony/mbms/ServiceInfo.aidl \
Robert Greenwalt4dded7a2016-12-05 16:33:32 -080040 frameworks/base/telephony/java/android/telephony/mbms/StreamingServiceInfo.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +000041 frameworks/base/telephony/java/android/telephony/ServiceState.aidl \
42 frameworks/base/telephony/java/android/telephony/SubscriptionInfo.aidl \
43 frameworks/base/telephony/java/android/telephony/CellInfo.aidl \
44 frameworks/base/telephony/java/android/telephony/SignalStrength.aidl \
45 frameworks/base/telephony/java/android/telephony/IccOpenLogicalChannelResponse.aidl \
46 frameworks/base/telephony/java/android/telephony/NeighboringCellInfo.aidl \
Prerepa Viswanadham5c728992015-05-28 00:12:37 -070047 frameworks/base/telephony/java/android/telephony/ModemActivityInfo.aidl \
Jeff Davidson35cda392017-02-27 09:46:00 -080048 frameworks/base/telephony/java/android/telephony/UiccAccessRule.aidl \
Jack Yu1d1022e2017-11-20 11:14:23 -080049 frameworks/base/telephony/java/android/telephony/data/DataProfile.aidl \
Jeff Davidson35cda392017-02-27 09:46:00 -080050 frameworks/base/telephony/java/android/telephony/euicc/DownloadableSubscription.aidl \
Jeff Davidson91c3d072017-04-12 12:17:11 -070051 frameworks/base/telephony/java/android/telephony/euicc/EuiccInfo.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +000052 frameworks/base/location/java/android/location/Location.aidl \
53 frameworks/base/location/java/android/location/Address.aidl \
54 frameworks/base/location/java/android/location/Criteria.aidl \
55 frameworks/base/media/java/android/media/MediaMetadata.aidl \
56 frameworks/base/media/java/android/media/MediaDescription.aidl \
57 frameworks/base/media/java/android/media/Rating.aidl \
58 frameworks/base/media/java/android/media/AudioAttributes.aidl \
59 frameworks/base/media/java/android/media/AudioFocusInfo.aidl \
60 frameworks/base/media/java/android/media/session/PlaybackState.aidl \
61 frameworks/base/media/java/android/media/session/MediaSession.aidl \
62 frameworks/base/media/java/android/media/tv/TvInputInfo.aidl \
63 frameworks/base/media/java/android/media/tv/TvTrackInfo.aidl \
64 frameworks/base/media/java/android/media/browse/MediaBrowser.aidl \
65 frameworks/base/wifi/java/android/net/wifi/ScanSettings.aidl \
Etan Cohen04133272016-10-26 11:22:06 -070066 frameworks/base/wifi/java/android/net/wifi/aware/ConfigRequest.aidl \
67 frameworks/base/wifi/java/android/net/wifi/aware/PublishConfig.aidl \
68 frameworks/base/wifi/java/android/net/wifi/aware/SubscribeConfig.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +000069 frameworks/base/wifi/java/android/net/wifi/p2p/WifiP2pInfo.aidl \
70 frameworks/base/wifi/java/android/net/wifi/p2p/WifiP2pDeviceList.aidl \
71 frameworks/base/wifi/java/android/net/wifi/p2p/WifiP2pConfig.aidl \
72 frameworks/base/wifi/java/android/net/wifi/p2p/WifiP2pDevice.aidl \
73 frameworks/base/wifi/java/android/net/wifi/p2p/WifiP2pGroup.aidl \
74 frameworks/base/wifi/java/android/net/wifi/p2p/nsd/WifiP2pServiceRequest.aidl \
75 frameworks/base/wifi/java/android/net/wifi/p2p/nsd/WifiP2pServiceInfo.aidl \
76 frameworks/base/wifi/java/android/net/wifi/WpsInfo.aidl \
77 frameworks/base/wifi/java/android/net/wifi/ScanResult.aidl \
Vinit Deshpandea772f0c2016-01-27 19:05:24 -080078 frameworks/base/wifi/java/android/net/wifi/PasspointManagementObjectDefinition.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +000079 frameworks/base/wifi/java/android/net/wifi/WifiEnterpriseConfig.aidl \
80 frameworks/base/wifi/java/android/net/wifi/WifiConfiguration.aidl \
81 frameworks/base/wifi/java/android/net/wifi/WifiInfo.aidl \
82 frameworks/base/graphics/java/android/graphics/Region.aidl \
83 frameworks/base/graphics/java/android/graphics/Bitmap.aidl \
84 frameworks/base/graphics/java/android/graphics/Point.aidl \
85 frameworks/base/graphics/java/android/graphics/PointF.aidl \
86 frameworks/base/graphics/java/android/graphics/RectF.aidl \
87 frameworks/base/graphics/java/android/graphics/Rect.aidl \
Philip P. Moltmannbb9f6862015-12-01 14:44:24 -080088 frameworks/base/graphics/java/android/graphics/drawable/Icon.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +000089 frameworks/base/core/java/android/accounts/AuthenticatorDescription.aidl \
90 frameworks/base/core/java/android/accounts/Account.aidl \
Michal Karpinskif77ee4f2016-10-12 16:40:06 +010091 frameworks/base/core/java/android/app/admin/ConnectEvent.aidl \
92 frameworks/base/core/java/android/app/admin/DnsEvent.aidl \
93 frameworks/base/core/java/android/app/admin/NetworkEvent.aidl \
Rubin Xud86d58c2015-05-05 16:57:37 +010094 frameworks/base/core/java/android/app/admin/SystemUpdatePolicy.aidl \
Andrew Scull5f9e6f32016-08-02 14:22:17 +010095 frameworks/base/core/java/android/app/admin/PasswordMetrics.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +000096 frameworks/base/core/java/android/print/PrintDocumentInfo.aidl \
97 frameworks/base/core/java/android/print/PageRange.aidl \
98 frameworks/base/core/java/android/print/PrintAttributes.aidl \
99 frameworks/base/core/java/android/print/PrinterCapabilitiesInfo.aidl \
100 frameworks/base/core/java/android/print/PrinterId.aidl \
101 frameworks/base/core/java/android/print/PrintJobInfo.aidl \
102 frameworks/base/core/java/android/print/PrinterInfo.aidl \
103 frameworks/base/core/java/android/print/PrintJobId.aidl \
Philip P. Moltmann9dcb86a2016-03-14 14:31:12 -0700104 frameworks/base/core/java/android/printservice/recommendation/RecommendationInfo.aidl \
Tomasz Wasilczyk8cfb0e82017-07-12 13:59:20 -0700105 frameworks/base/core/java/android/hardware/radio/ProgramSelector.aidl \
Tomasz Wasilczyk347192e2017-04-04 11:13:44 -0700106 frameworks/base/core/java/android/hardware/radio/RadioManager.aidl \
Tomasz Wasilczykc9a1ac72017-05-17 21:29:28 -0700107 frameworks/base/core/java/android/hardware/radio/RadioMetadata.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000108 frameworks/base/core/java/android/hardware/usb/UsbDevice.aidl \
109 frameworks/base/core/java/android/hardware/usb/UsbInterface.aidl \
110 frameworks/base/core/java/android/hardware/usb/UsbEndpoint.aidl \
111 frameworks/base/core/java/android/hardware/usb/UsbAccessory.aidl \
112 frameworks/base/core/java/android/os/Messenger.aidl \
113 frameworks/base/core/java/android/os/PatternMatcher.aidl \
114 frameworks/base/core/java/android/os/Message.aidl \
115 frameworks/base/core/java/android/os/UserHandle.aidl \
116 frameworks/base/core/java/android/os/ParcelUuid.aidl \
117 frameworks/base/core/java/android/os/ParcelFileDescriptor.aidl \
118 frameworks/base/core/java/android/os/ResultReceiver.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000119 frameworks/base/core/java/android/os/WorkSource.aidl \
120 frameworks/base/core/java/android/os/DropBoxManager.aidl \
121 frameworks/base/core/java/android/os/Bundle.aidl \
Sudheer Shankacc6418f2016-10-13 12:03:44 -0700122 frameworks/base/core/java/android/os/Debug.aidl \
John Reckdea6a022017-05-25 17:09:33 -0700123 frameworks/base/core/java/android/os/SharedMemory.aidl \
Sudheer Shankafc46e9b2016-10-21 17:55:27 -0700124 frameworks/base/core/java/android/os/StrictMode.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000125 frameworks/base/core/java/android/accessibilityservice/AccessibilityServiceInfo.aidl \
126 frameworks/base/core/java/android/net/Network.aidl \
127 frameworks/base/core/java/android/net/RouteInfo.aidl \
128 frameworks/base/core/java/android/net/NetworkInfo.aidl \
129 frameworks/base/core/java/android/net/IpPrefix.aidl \
130 frameworks/base/core/java/android/net/NetworkCapabilities.aidl \
131 frameworks/base/core/java/android/net/DhcpInfo.aidl \
132 frameworks/base/core/java/android/net/ProxyInfo.aidl \
133 frameworks/base/core/java/android/net/LinkProperties.aidl \
134 frameworks/base/core/java/android/net/Uri.aidl \
135 frameworks/base/core/java/android/net/NetworkRequest.aidl \
136 frameworks/base/core/java/android/net/LinkAddress.aidl \
Svet Ganov53a441c2016-04-19 19:38:00 -0700137 frameworks/base/core/java/android/util/MemoryIntArray.aidl \
P.Y. Laligandb3b9eb32015-05-11 15:02:07 -0700138 frameworks/base/core/java/android/view/Display.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000139 frameworks/base/core/java/android/view/InputDevice.aidl \
140 frameworks/base/core/java/android/view/InputEvent.aidl \
Eino-Ville Talvala5d2d7782015-12-17 16:50:50 -0800141 frameworks/native/aidl/gui/android/view/Surface.aidl \
P.Y. Laligandb3b9eb32015-05-11 15:02:07 -0700142 frameworks/base/core/java/android/view/WindowContentFrameStats.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000143 frameworks/base/core/java/android/view/inputmethod/InputMethodSubtype.aidl \
144 frameworks/base/core/java/android/view/inputmethod/CursorAnchorInfo.aidl \
145 frameworks/base/core/java/android/view/inputmethod/CompletionInfo.aidl \
146 frameworks/base/core/java/android/view/inputmethod/ExtractedText.aidl \
147 frameworks/base/core/java/android/view/inputmethod/EditorInfo.aidl \
148 frameworks/base/core/java/android/view/inputmethod/InputMethodInfo.aidl \
149 frameworks/base/core/java/android/view/inputmethod/CorrectionInfo.aidl \
150 frameworks/base/core/java/android/view/inputmethod/InputBinding.aidl \
151 frameworks/base/core/java/android/view/inputmethod/ExtractedTextRequest.aidl \
152 frameworks/base/core/java/android/view/DragEvent.aidl \
153 frameworks/base/core/java/android/view/KeyEvent.aidl \
154 frameworks/base/core/java/android/view/WindowManager.aidl \
155 frameworks/base/core/java/android/view/WindowAnimationFrameStats.aidl \
156 frameworks/base/core/java/android/view/MotionEvent.aidl \
157 frameworks/base/core/java/android/view/accessibility/AccessibilityNodeInfo.aidl \
158 frameworks/base/core/java/android/view/accessibility/AccessibilityRecord.aidl \
159 frameworks/base/core/java/android/view/accessibility/AccessibilityWindowInfo.aidl \
160 frameworks/base/core/java/android/view/accessibility/AccessibilityEvent.aidl \
161 frameworks/base/core/java/android/view/textservice/SpellCheckerSubtype.aidl \
162 frameworks/base/core/java/android/view/textservice/TextInfo.aidl \
163 frameworks/base/core/java/android/view/textservice/SpellCheckerInfo.aidl \
164 frameworks/base/core/java/android/view/textservice/SentenceSuggestionsInfo.aidl \
165 frameworks/base/core/java/android/view/textservice/SuggestionsInfo.aidl \
166 frameworks/base/core/java/android/service/carrier/CarrierIdentifier.aidl \
167 frameworks/base/core/java/android/service/carrier/MessagePdu.aidl \
Jeff Davidson91c3d072017-04-12 12:17:11 -0700168 frameworks/base/core/java/android/service/euicc/GetDefaultDownloadableSubscriptionListResult.aidl \
Jeff Davidson35cda392017-02-27 09:46:00 -0800169 frameworks/base/core/java/android/service/euicc/GetDownloadableSubscriptionMetadataResult.aidl \
Jeff Davidsond02731f2017-04-09 14:31:09 -0700170 frameworks/base/core/java/android/service/euicc/GetEuiccProfileInfoListResult.aidl \
Julia Reynolds22f02b32016-12-01 15:05:13 -0500171 frameworks/base/core/java/android/service/notification/Adjustment.aidl \
172 frameworks/base/core/java/android/service/notification/Condition.aidl \
173 frameworks/base/core/java/android/service/notification/SnoozeCriterion.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000174 frameworks/base/core/java/android/service/notification/StatusBarNotification.aidl \
175 frameworks/base/core/java/android/service/chooser/ChooserTarget.aidl \
Kang Libbced1c2017-04-05 12:30:55 -0700176 frameworks/base/core/java/android/service/resolver/ResolverTarget.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000177 frameworks/base/core/java/android/speech/tts/Voice.aidl \
Daniel Nishicf9d19e2017-01-23 14:33:42 -0800178 frameworks/base/core/java/android/app/usage/CacheQuotaHint.aidl \
Jeff Sharkey8dedad32017-01-09 18:21:21 -0700179 frameworks/base/core/java/android/app/usage/ExternalStorageStats.aidl \
Jeff Sharkeye8cece92017-01-04 11:33:33 -0700180 frameworks/base/core/java/android/app/usage/StorageStats.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000181 frameworks/base/core/java/android/app/usage/UsageEvents.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000182 frameworks/base/core/java/android/app/Notification.aidl \
183 frameworks/base/core/java/android/app/NotificationManager.aidl \
184 frameworks/base/core/java/android/app/WallpaperInfo.aidl \
185 frameworks/base/core/java/android/app/AppOpsManager.aidl \
186 frameworks/base/core/java/android/app/ActivityManager.aidl \
187 frameworks/base/core/java/android/app/PendingIntent.aidl \
188 frameworks/base/core/java/android/app/AlarmManager.aidl \
189 frameworks/base/core/java/android/app/SearchableInfo.aidl \
190 frameworks/base/core/java/android/app/VoiceInteractor.aidl \
Dianne Hackborn69c6adc2015-06-02 10:52:59 -0700191 frameworks/base/core/java/android/app/assist/AssistContent.aidl \
192 frameworks/base/core/java/android/app/assist/AssistStructure.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000193 frameworks/base/core/java/android/app/job/JobParameters.aidl \
194 frameworks/base/core/java/android/app/job/JobInfo.aidl \
195 frameworks/base/core/java/android/appwidget/AppWidgetProviderInfo.aidl \
196 frameworks/base/core/java/android/content/ClipDescription.aidl \
197 frameworks/base/core/java/android/content/IntentFilter.aidl \
198 frameworks/base/core/java/android/content/Intent.aidl \
199 frameworks/base/core/java/android/content/res/Configuration.aidl \
200 frameworks/base/core/java/android/content/res/ObbInfo.aidl \
201 frameworks/base/core/java/android/content/RestrictionEntry.aidl \
202 frameworks/base/core/java/android/content/ClipData.aidl \
203 frameworks/base/core/java/android/content/SyncAdapterType.aidl \
204 frameworks/base/core/java/android/content/SyncRequest.aidl \
205 frameworks/base/core/java/android/content/PeriodicSync.aidl \
206 frameworks/base/core/java/android/content/SyncResult.aidl \
207 frameworks/base/core/java/android/content/pm/FeatureInfo.aidl \
208 frameworks/base/core/java/android/content/pm/InstrumentationInfo.aidl \
209 frameworks/base/core/java/android/content/pm/PackageInstaller.aidl \
210 frameworks/base/core/java/android/content/pm/ServiceInfo.aidl \
211 frameworks/base/core/java/android/content/pm/Signature.aidl \
212 frameworks/base/core/java/android/content/pm/ApplicationInfo.aidl \
213 frameworks/base/core/java/android/content/pm/PermissionInfo.aidl \
214 frameworks/base/core/java/android/content/pm/ActivityInfo.aidl \
Sudheer Shankafc46e9b2016-10-21 17:55:27 -0700215 frameworks/base/core/java/android/content/pm/ConfigurationInfo.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000216 frameworks/base/core/java/android/content/pm/PackageInfo.aidl \
217 frameworks/base/core/java/android/content/pm/ResolveInfo.aidl \
218 frameworks/base/core/java/android/content/pm/ProviderInfo.aidl \
219 frameworks/base/core/java/android/content/pm/PackageStats.aidl \
220 frameworks/base/core/java/android/content/pm/PermissionGroupInfo.aidl \
Makoto Onuki6f7362d92016-03-04 13:39:41 -0800221 frameworks/base/core/java/android/content/pm/ShortcutInfo.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000222 frameworks/base/core/java/android/content/pm/LabeledIntent.aidl \
223 frameworks/base/core/java/android/content/ComponentName.aidl \
224 frameworks/base/core/java/android/content/SyncStats.aidl \
225 frameworks/base/core/java/android/content/ContentValues.aidl \
226 frameworks/base/core/java/android/content/SyncInfo.aidl \
227 frameworks/base/core/java/android/content/IntentSender.aidl \
228 frameworks/base/core/java/android/widget/RemoteViews.aidl \
229 frameworks/base/core/java/android/text/style/SuggestionSpan.aidl \
230 frameworks/base/core/java/android/nfc/Tag.aidl \
231 frameworks/base/core/java/android/nfc/NdefRecord.aidl \
232 frameworks/base/core/java/android/nfc/NdefMessage.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000233 frameworks/base/core/java/android/database/CursorWindow.aidl \
Jason Monkbbadff82015-11-06 15:47:26 -0500234 frameworks/base/core/java/android/service/quicksettings/Tile.aidl \
Samuel Tan239951a2016-01-05 17:29:43 -0800235 frameworks/native/aidl/binder/android/os/PersistableBundle.aidl \
Jakub Pawlowski3b38eaa2017-08-09 00:45:34 -0700236 system/bt/binder/android/bluetooth/BluetoothHealthAppConfiguration.aidl \
237 system/bt/binder/android/bluetooth/le/AdvertiseSettings.aidl \
238 system/bt/binder/android/bluetooth/le/ScanSettings.aidl \
239 system/bt/binder/android/bluetooth/le/AdvertiseData.aidl \
240 system/bt/binder/android/bluetooth/le/ScanFilter.aidl \
241 system/bt/binder/android/bluetooth/le/ScanResult.aidl \
242 system/bt/binder/android/bluetooth/BluetoothDevice.aidl \
Robin Lee10606942016-03-30 18:52:40 +0100243 system/netd/server/binder/android/net/UidRange.aidl \
Robert Greenwalt37409c52016-06-02 13:43:27 -0700244 frameworks/base/telephony/java/android/telephony/PcoData.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000245
246gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
247$(gen): PRIVATE_SRC_FILES := $(aidl_files)
248ALL_SDK_FILES += $(gen)
249$(gen): $(aidl_files) | $(AIDL)
250 @echo Aidl Preprocess: $@
251 $(hide) $(AIDL) --preprocess $@ $(PRIVATE_SRC_FILES)
252
253# the documentation
254# ============================================================
255
256# TODO: deal with com/google/android/googleapps
257packages_to_document := \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800258 android \
259 javax/microedition/khronos \
260 org/apache/http/conn \
261 org/apache/http/params \
Bart Searsa8cc0582015-05-07 03:23:20 +0000262
263# include definition of libcore_to_document
264include libcore/Docs.mk
265
Bart Searsa8cc0582015-05-07 03:23:20 +0000266non_base_dirs := \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800267 ../opt/telephony/src/java/android/telephony \
268 ../opt/telephony/src/java/android/telephony/gsm \
269 ../opt/net/voip/src/java/android/net/rtp \
270 ../opt/net/voip/src/java/android/net/sip \
Bart Searsa8cc0582015-05-07 03:23:20 +0000271
Paul Duffinc08090f2017-06-29 14:58:43 +0100272framework_base_android_test_mock_src_files := \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800273 $(call all-java-files-under, test-runner/src/android/test/mock)
Paul Duffinc08090f2017-06-29 14:58:43 +0100274
275framework_base_android_test_runner_excluding_mock_src_files := \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800276 $(filter-out $(framework_base_android_test_mock_src_files), $(call all-java-files-under, test-runner/src))
Paul Duffinc08090f2017-06-29 14:58:43 +0100277
Colin Cross5f4dcf62017-11-16 00:15:28 -0800278# Find all files in specific directories (relative to frameworks/base)
279# to document and check apis
280files_to_check_apis := \
281 $(call find-other-java-files, \
282 legacy-test/src \
283 $(non_base_dirs) \
284 )
Bart Searsa8cc0582015-05-07 03:23:20 +0000285
Colin Cross5f4dcf62017-11-16 00:15:28 -0800286# Find all files in specific packages that were used to compile
287# framework.jar to document and check apis
288files_to_check_apis += \
289 $(addprefix ../../,\
290 $(filter \
291 $(foreach dir,$(FRAMEWORKS_BASE_JAVA_SRC_DIRS),\
292 $(foreach package,$(packages_to_document),\
293 $(dir)/$(package)/%.java)),\
294 $(SOONG_FRAMEWORK_SRCS)))
295
296# Find all generated files that were used to compile framework.jar
Colin Cross0c760952017-12-04 13:45:19 -0800297files_to_check_apis_generated := \
298 $(filter $(OUT_DIR)/%,\
299 $(SOONG_FRAMEWORK_SRCS))
George Mountf6be9932015-12-03 07:39:55 -0800300
Bart Searsa8cc0582015-05-07 03:23:20 +0000301# These are relative to frameworks/base
302# FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
Colin Cross5f4dcf62017-11-16 00:15:28 -0800303files_to_document := \
304 $(files_to_check_apis) \
305 $(call find-other-java-files,\
306 $(addprefix ../../, $(FRAMEWORKS_DATA_BINDING_JAVA_SRC_DIRS)) \
307 test-runner/src)
George Mountf6be9932015-12-03 07:39:55 -0800308
Bart Searsa8cc0582015-05-07 03:23:20 +0000309# These are relative to frameworks/base
310html_dirs := \
311 $(FRAMEWORKS_BASE_SUBDIRS) \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800312 $(non_base_dirs) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000313
314# Common sources for doc check and api check
315common_src_files := \
316 $(call find-other-html-files, $(html_dirs)) \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800317 $(addprefix ../../, $(libcore_to_document)) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000318
319# These are relative to frameworks/base
320framework_docs_LOCAL_SRC_FILES := \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800321 $(files_to_document) \
322 $(common_src_files) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000323
324# These are relative to frameworks/base
325framework_docs_LOCAL_API_CHECK_SRC_FILES := \
Colin Cross5f4dcf62017-11-16 00:15:28 -0800326 $(framework_base_android_test_mock_src_files) \
327 $(framework_base_android_test_runner_excluding_mock_src_files) \
328 $(files_to_check_apis) \
329 $(common_src_files) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000330
331# This is used by ide.mk as the list of source files that are
332# always included.
333INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
334
335framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
336 $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
337
Colin Cross5f4dcf62017-11-16 00:15:28 -0800338framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS)
339
Colin Cross0c760952017-12-04 13:45:19 -0800340framework_docs_LOCAL_GENERATED_SOURCES := \
341 $(libcore_to_document_generated) \
342 $(files_to_check_apis_generated) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000343
344framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \
Piotr Jastrzebskicfa292e2015-02-17 16:58:52 +0000345 core-oj \
Bart Searsa8cc0582015-05-07 03:23:20 +0000346 core-libart \
347 conscrypt \
348 bouncycastle \
349 okhttp \
350 ext \
Rayhaan Jaufeerally2e47a6e2015-08-03 13:54:28 +0100351 icu4j \
Bart Searsa8cc0582015-05-07 03:23:20 +0000352 framework \
Paul Duffinc08090f2017-06-29 14:58:43 +0100353 voip-common \
354 android.test.mock \
Bart Searsa8cc0582015-05-07 03:23:20 +0000355
Alan Viverette2d362a52017-04-05 10:21:58 -0400356# Platform docs can refer to Support Library APIs, but we don't actually build
357# them as part of the docs target, so we need to include them on the classpath.
Bart Searsa8cc0582015-05-07 03:23:20 +0000358framework_docs_LOCAL_JAVA_LIBRARIES := \
359 $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \
360 $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES)
361
362framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES
363framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html
364# The since flag (-since N.xml API_LEVEL) is used to add API Level information
365# to the reference documentation. Must be in order of oldest to newest.
366#
367# Conscrypt (com.android.org.conscrypt) is an implementation detail and should
368# not be referenced in the documentation.
369framework_docs_LOCAL_DROIDDOC_OPTIONS := \
Jeff Sharkey0f3f60b2017-04-24 18:06:20 -0600370 -android \
Bart Searsa8cc0582015-05-07 03:23:20 +0000371 -knowntags ./frameworks/base/docs/knowntags.txt \
Narayan Kamath2c4f2842015-07-27 14:02:11 +0100372 -knowntags ./libcore/known_oj_tags.txt \
Jeff Sharkeybfc4fcd2017-06-05 17:38:17 -0600373 -manifest ./frameworks/base/core/res/AndroidManifest.xml \
Jeff Sharkeybc4f48b2017-12-06 21:02:11 -0700374 -hidePackage com.android.okhttp \
Bart Searsa8cc0582015-05-07 03:23:20 +0000375 -hidePackage com.android.org.conscrypt \
Jeff Sharkeybc4f48b2017-12-06 21:02:11 -0700376 -hidePackage com.android.server \
Bart Searsa8cc0582015-05-07 03:23:20 +0000377 -since $(SRC_API_DIR)/1.xml 1 \
378 -since $(SRC_API_DIR)/2.xml 2 \
379 -since $(SRC_API_DIR)/3.xml 3 \
380 -since $(SRC_API_DIR)/4.xml 4 \
381 -since $(SRC_API_DIR)/5.xml 5 \
382 -since $(SRC_API_DIR)/6.xml 6 \
383 -since $(SRC_API_DIR)/7.xml 7 \
384 -since $(SRC_API_DIR)/8.xml 8 \
385 -since $(SRC_API_DIR)/9.xml 9 \
386 -since $(SRC_API_DIR)/10.xml 10 \
387 -since $(SRC_API_DIR)/11.xml 11 \
388 -since $(SRC_API_DIR)/12.xml 12 \
389 -since $(SRC_API_DIR)/13.xml 13 \
390 -since $(SRC_API_DIR)/14.txt 14 \
391 -since $(SRC_API_DIR)/15.txt 15 \
392 -since $(SRC_API_DIR)/16.txt 16 \
393 -since $(SRC_API_DIR)/17.txt 17 \
394 -since $(SRC_API_DIR)/18.txt 18 \
395 -since $(SRC_API_DIR)/19.txt 19 \
396 -since $(SRC_API_DIR)/20.txt 20 \
397 -since $(SRC_API_DIR)/21.txt 21 \
398 -since $(SRC_API_DIR)/22.txt 22 \
Joe Fernandez1827e322015-08-12 19:45:22 -0700399 -since $(SRC_API_DIR)/23.txt 23 \
Dirk Dougherty5f60f7c2016-06-14 16:26:28 -0700400 -since $(SRC_API_DIR)/24.txt 24 \
Dirk Dougherty3376f582016-10-14 10:27:08 -0700401 -since $(SRC_API_DIR)/25.txt 25 \
Dirk Doughertyfdad0ba2017-06-09 14:43:32 -0700402 -since $(SRC_API_DIR)/26.txt 26 \
Andrew Solovaya6019b22017-10-06 14:27:20 -0700403 -since $(SRC_API_DIR)/27.txt 27 \
Jeff Sharkey2337aec2017-12-06 21:12:23 -0700404 -werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 \
Jeff Sharkey0f3f60b2017-04-24 18:06:20 -0600405 -overview $(LOCAL_PATH)/core/java/overview.html \
Bart Searsa8cc0582015-05-07 03:23:20 +0000406
407framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \
408 $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)
409
410framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \
Alan Viverette2d362a52017-04-05 10:21:58 -0400411 $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
Bart Searsa8cc0582015-05-07 03:23:20 +0000412
413framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
Narayan Kamathc21739a2015-07-14 13:39:23 +0100414 frameworks/base/docs/knowntags.txt \
Colin Cross72d359f2017-10-27 10:46:53 -0700415 $(libcore_to_document_generated)
Bart Searsa8cc0582015-05-07 03:23:20 +0000416
417samples_dir := development/samples/browseable
418
419# Whitelist of valid groups, used for default TOC grouping. Each sample must
420# belong to one (and only one) group. Assign samples to groups by setting
421# a sample.group var to one of these groups in the sample's _index.jd.
422sample_groups := -samplegroup Admin \
423 -samplegroup Background \
424 -samplegroup Connectivity \
425 -samplegroup Content \
426 -samplegroup Input \
427 -samplegroup Media \
428 -samplegroup Notification \
429 -samplegroup RenderScript \
430 -samplegroup Security \
431 -samplegroup Sensors \
Trevor Johns4cbe3592015-05-27 14:50:51 -0700432 -samplegroup System \
Bart Searsa8cc0582015-05-07 03:23:20 +0000433 -samplegroup Testing \
434 -samplegroup UI \
435 -samplegroup Views \
436 -samplegroup Wearable
437
438## SDK version identifiers used in the published docs
439 # major[.minor] version for current SDK. (full releases only)
smain@google.comdde8deb2016-08-29 18:36:50 -0700440framework_docs_SDK_VERSION:=7.0
Bart Searsa8cc0582015-05-07 03:23:20 +0000441 # release version (ie "Release x") (full releases only)
442framework_docs_SDK_REL_ID:=1
443
444framework_docs_LOCAL_DROIDDOC_OPTIONS += \
Billy Lamberta75dbc8f2017-03-03 13:09:15 -0800445 -hdf dac true \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700446 -hdf sdk.codename O \
447 -hdf sdk.preview.version 1 \
Bart Searsa8cc0582015-05-07 03:23:20 +0000448 -hdf sdk.version $(framework_docs_SDK_VERSION) \
449 -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700450 -hdf sdk.preview 0 \
451 -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \
452 -resourcesoutdir reference/android/images/
Bart Searsa8cc0582015-05-07 03:23:20 +0000453
Alan Viverette2d362a52017-04-05 10:21:58 -0400454# Federate Support Library references against local API file.
455framework_docs_LOCAL_DROIDDOC_OPTIONS += \
456 -federate SupportLib https://developer.android.com \
457 -federationapi SupportLib prebuilts/sdk/current/support-api.txt
458
Bart Searsa8cc0582015-05-07 03:23:20 +0000459# ==== the api stubs and current.xml ===========================
460include $(CLEAR_VARS)
461
462LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800463LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800464LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000465LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
466LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
467LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
468LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
469LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
470LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
471
472LOCAL_MODULE := api-stubs
473
Ying Wang0f92a2e2015-07-16 14:20:22 -0700474LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src
475
Bart Searsa8cc0582015-05-07 03:23:20 +0000476LOCAL_DROIDDOC_OPTIONS:=\
477 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700478 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000479 -api $(INTERNAL_PLATFORM_API_FILE) \
480 -removedApi $(INTERNAL_PLATFORM_REMOVED_API_FILE) \
481 -nodocs
482
Scott Main15b85172017-02-21 14:30:58 -0800483LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000484
485LOCAL_UNINSTALLABLE_MODULE := true
486
487include $(BUILD_DROIDDOC)
488
489# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
Colin Cross5f4dcf62017-11-16 00:15:28 -0800490$(full_target): $(gen)
Bart Searsa8cc0582015-05-07 03:23:20 +0000491$(INTERNAL_PLATFORM_API_FILE): $(full_target)
492$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
493
494# ==== the system api stubs ===================================
495include $(CLEAR_VARS)
496
497LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800498LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800499LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000500LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
501LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
502LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
503LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
504LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
505LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
506
507LOCAL_MODULE := system-api-stubs
508
Ying Wang0f92a2e2015-07-16 14:20:22 -0700509LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src
510
Bart Searsa8cc0582015-05-07 03:23:20 +0000511LOCAL_DROIDDOC_OPTIONS:=\
512 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700513 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000514 -showAnnotation android.annotation.SystemApi \
515 -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
516 -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
Jeff Sharkey05461c02017-05-09 19:01:09 -0600517 -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000518 -nodocs
519
Scott Main15b85172017-02-21 14:30:58 -0800520LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000521
522LOCAL_UNINSTALLABLE_MODULE := true
523
524include $(BUILD_DROIDDOC)
525
526# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
Colin Cross5f4dcf62017-11-16 00:15:28 -0800527$(full_target): $(gen)
Bart Searsa8cc0582015-05-07 03:23:20 +0000528$(INTERNAL_PLATFORM_SYSTEM_API_FILE): $(full_target)
529$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE))
530
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000531# ==== the test api stubs ===================================
532include $(CLEAR_VARS)
533
534LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800535LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800536LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000537LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
538LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
539LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
540LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
541LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
542LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
543
544LOCAL_MODULE := test-api-stubs
545
546LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src
547
548LOCAL_DROIDDOC_OPTIONS:=\
549 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700550 -referenceonly \
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000551 -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \
552 -showAnnotation android.annotation.TestApi \
553 -api $(INTERNAL_PLATFORM_TEST_API_FILE) \
554 -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
Jeff Sharkey05461c02017-05-09 19:01:09 -0600555 -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000556 -nodocs
557
Scott Main15b85172017-02-21 14:30:58 -0800558LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000559
560LOCAL_UNINSTALLABLE_MODULE := true
561
562include $(BUILD_DROIDDOC)
563
564# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
Colin Cross5f4dcf62017-11-16 00:15:28 -0800565$(full_target): $(gen)
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000566$(INTERNAL_PLATFORM_TEST_API_FILE): $(full_target)
567$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE))
568
Bart Searsa8cc0582015-05-07 03:23:20 +0000569# ==== check javadoc comments but don't generate docs ========
570include $(CLEAR_VARS)
571
572LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800573LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800574LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000575LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
576LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
577LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
578LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
579LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
580LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
581
582LOCAL_MODULE := doc-comment-check
583
584LOCAL_DROIDDOC_OPTIONS:=\
585 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700586 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000587 -parsecomments
588
Scott Main15b85172017-02-21 14:30:58 -0800589LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000590
591LOCAL_UNINSTALLABLE_MODULE := true
592
593include $(BUILD_DROIDDOC)
594
595# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
Colin Cross5f4dcf62017-11-16 00:15:28 -0800596$(full_target): $(gen)
Bart Searsa8cc0582015-05-07 03:23:20 +0000597
598# Run this for checkbuild
599checkbuild: doc-comment-check-docs
600# Check comment when you are updating the API
601update-api: doc-comment-check-docs
602
603# ==== static html in the sdk ==================================
604include $(CLEAR_VARS)
605
606LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800607LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800608LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000609LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
610LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
611LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
612LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
613LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
614LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
615
616LOCAL_MODULE := offline-sdk
617
618LOCAL_DROIDDOC_OPTIONS:=\
619 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
620 -offlinemode \
621 -title "Android SDK" \
622 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
smain@google.com00de8c52016-03-07 18:38:08 -0800623 -sdkvalues $(OUT_DOCS) \
smain@google.com8562ab52016-06-14 17:11:57 -0700624 -hdf android.whichdoc offline
625
Scott Main15b85172017-02-21 14:30:58 -0800626LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
smain@google.com8562ab52016-06-14 17:11:57 -0700627
628include $(BUILD_DROIDDOC)
629
630static_doc_index_redirect := $(out_dir)/index.html
631$(static_doc_index_redirect): \
632 $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP)
633 $(hide) mkdir -p $(dir $@)
634 $(hide) $(ACP) $< $@
635
636$(full_target): $(static_doc_index_redirect)
smain@google.com8562ab52016-06-14 17:11:57 -0700637
638
639# ==== static html in the sdk ==================================
640include $(CLEAR_VARS)
641
642LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800643LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800644LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
smain@google.com8562ab52016-06-14 17:11:57 -0700645LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_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_ADDITIONAL_JAVA_DIR)
650LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
651
652LOCAL_MODULE := offline-sdk-referenceonly
653
654LOCAL_DROIDDOC_OPTIONS:=\
655 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
656 -offlinemode \
657 -title "Android SDK" \
658 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
659 -sdkvalues $(OUT_DOCS) \
smain@google.com00de8c52016-03-07 18:38:08 -0800660 -hdf android.whichdoc offline \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700661 -referenceonly
smain@google.com00de8c52016-03-07 18:38:08 -0800662
Scott Main15b85172017-02-21 14:30:58 -0800663LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
smain@google.com00de8c52016-03-07 18:38:08 -0800664
665include $(BUILD_DROIDDOC)
666
667static_doc_index_redirect := $(out_dir)/index.html
smain@google.com151833a2016-08-31 08:42:09 -0700668$(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
Dan Willemsen98ff0b72016-03-23 00:42:44 -0700669 $(copy-file-to-target)
smain@google.com00de8c52016-03-07 18:38:08 -0800670
smain@google.com2f2365d2016-09-21 14:05:50 -0700671static_doc_properties := $(out_dir)/source.properties
672$(static_doc_properties): \
673 $(LOCAL_PATH)/docs/source.properties | $(ACP)
674 $(hide) mkdir -p $(dir $@)
675 $(hide) $(ACP) $< $@
676
smain@google.com00de8c52016-03-07 18:38:08 -0800677$(full_target): $(static_doc_index_redirect)
smain@google.com2f2365d2016-09-21 14:05:50 -0700678$(full_target): $(static_doc_properties)
smain@google.com00de8c52016-03-07 18:38:08 -0800679
smain@google.com7aca8be2016-03-10 14:13:30 -0800680
Bart Searsa8cc0582015-05-07 03:23:20 +0000681# ==== docs for the web (on the androiddevdocs app engine server) =======================
682include $(CLEAR_VARS)
683
684LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800685LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800686LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000687LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
688LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
689LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
690LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
691LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
692LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
693LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
694LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
695
696LOCAL_MODULE := online-sdk
697
698LOCAL_DROIDDOC_OPTIONS:= \
699 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
700 -toroot / \
701 -hdf android.whichdoc online \
702 $(sample_groups) \
703 -hdf android.hasSamples true \
704 -samplesdir $(samples_dir)
705
Scott Main15b85172017-02-21 14:30:58 -0800706LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000707
708include $(BUILD_DROIDDOC)
709
710# ==== docs for the web (on the androiddevdocs app engine server) =======================
Bart Searsa8cc0582015-05-07 03:23:20 +0000711include $(CLEAR_VARS)
712
713LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800714LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800715LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000716LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
717LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
718LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
719LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
720LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
721LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
722LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
723LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
724
725LOCAL_MODULE := online-system-api-sdk
726
727LOCAL_DROIDDOC_OPTIONS:= \
728 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700729 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000730 -showAnnotation android.annotation.SystemApi \
731 -title "Android SDK - Including system APIs." \
732 -toroot / \
Gina Dimino98ad8882016-05-31 17:25:48 -0700733 -hide 101 \
734 -hide 104 \
735 -hide 108 \
Bart Searsa8cc0582015-05-07 03:23:20 +0000736 -hdf android.whichdoc online \
737 $(sample_groups) \
738 -hdf android.hasSamples true \
739 -samplesdir $(samples_dir)
740
Scott Main15b85172017-02-21 14:30:58 -0800741LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Jeff Sharkey05461c02017-05-09 19:01:09 -0600742
Bart Searsa8cc0582015-05-07 03:23:20 +0000743LOCAL_UNINSTALLABLE_MODULE := true
744
745include $(BUILD_DROIDDOC)
Bart Searsa8cc0582015-05-07 03:23:20 +0000746
747# ==== docs for the web (on the devsite app engine server) =======================
748include $(CLEAR_VARS)
749LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800750LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800751LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000752LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
753LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
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# specify a second html input dir and an output path relative to OUT_DIR)
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700760LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
Bart Searsa8cc0582015-05-07 03:23:20 +0000761
762LOCAL_MODULE := ds
763
764LOCAL_DROIDDOC_OPTIONS:= \
765 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000766 -toroot / \
767 -hdf android.whichdoc online \
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700768 -devsite \
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700769 $(sample_groups) \
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700770 -hdf android.hasSamples true \
771 -samplesdir $(samples_dir)
Bart Searsa8cc0582015-05-07 03:23:20 +0000772
Scott Main15b85172017-02-21 14:30:58 -0800773LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000774
775include $(BUILD_DROIDDOC)
776
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700777# ==== docs for the web (on the devsite app engine server) =======================
778include $(CLEAR_VARS)
779LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800780LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800781LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700782LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
783LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
784LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
785LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
786LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
787LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
788LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
789# specify a second html input dir and an output path relative to OUT_DIR)
790LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
791
792LOCAL_MODULE := ds-static
793
794LOCAL_DROIDDOC_OPTIONS:= \
795 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
796 -hdf android.whichdoc online \
797 -staticonly \
798 -toroot / \
799 -devsite \
800 -ignoreJdLinks
801
Scott Main15b85172017-02-21 14:30:58 -0800802LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700803
804include $(BUILD_DROIDDOC)
805
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700806# ==== generates full navtree for resolving @links in ds postprocessing ====
807include $(CLEAR_VARS)
808
809LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800810LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800811LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700812LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
813LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
814LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
815LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
816LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
817LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
818
819LOCAL_MODULE := ds-ref-navtree
820
821LOCAL_DROIDDOC_OPTIONS:= \
822 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
823 -hdf android.whichdoc online \
824 -toroot / \
825 -atLinksNavtree \
826 -navtreeonly
827
Scott Main15b85172017-02-21 14:30:58 -0800828LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700829
830include $(BUILD_DROIDDOC)
831
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800832# ==== site updates for docs (on the androiddevdocs app engine server) =======================
Bart Searsa8cc0582015-05-07 03:23:20 +0000833include $(CLEAR_VARS)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800834
Bart Searsa8cc0582015-05-07 03:23:20 +0000835LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800836LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800837LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000838LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
839LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
840LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
841LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800842LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
Bart Searsa8cc0582015-05-07 03:23:20 +0000843LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
844LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800845LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
Bart Searsa8cc0582015-05-07 03:23:20 +0000846
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800847LOCAL_MODULE := online-sdk-dev
Bart Searsa8cc0582015-05-07 03:23:20 +0000848
849LOCAL_DROIDDOC_OPTIONS:= \
850 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
851 -toroot / \
852 -hdf android.whichdoc online \
853 $(sample_groups) \
854 -hdf android.hasSamples true \
855 -samplesdir $(samples_dir)
856
Scott Main15b85172017-02-21 14:30:58 -0800857LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000858
859include $(BUILD_DROIDDOC)
860
Bart Searsa8cc0582015-05-07 03:23:20 +0000861# ==== docs that have all of the stuff that's @hidden =======================
862include $(CLEAR_VARS)
863
864LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800865LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross5f4dcf62017-11-16 00:15:28 -0800866LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000867LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
868LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
869LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
870LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
871LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
872LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
873
874LOCAL_MODULE := hidden
875LOCAL_DROIDDOC_OPTIONS:=\
876 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700877 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000878 -title "Android SDK - Including hidden APIs."
879# -hidden
880
Scott Main15b85172017-02-21 14:30:58 -0800881LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000882
883include $(BUILD_DROIDDOC)
884
Joe Onorato1754d742016-11-21 17:51:35 -0800885# ==== java proto host library ==============================
886include $(CLEAR_VARS)
887LOCAL_MODULE := platformprotos
888LOCAL_PROTOC_OPTIMIZE_TYPE := full
889LOCAL_PROTOC_FLAGS := \
890 -Iexternal/protobuf/src
891LOCAL_SOURCE_FILES_ALL_GENERATED := true
892LOCAL_SRC_FILES := \
893 $(call all-proto-files-under, core/proto) \
894 $(call all-proto-files-under, libs/incident/proto)
895include $(BUILD_HOST_JAVA_LIBRARY)
896
Bart Searsa8cc0582015-05-07 03:23:20 +0000897
898# Include subdirectory makefiles
899# ============================================================
900
901# If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
902# team really wants is to build the stuff defined by this makefile.
903ifeq (,$(ONE_SHOT_MAKEFILE))
904include $(call first-makefiles-under,$(LOCAL_PATH))
905endif
906
907endif # ANDROID_BUILD_EMBEDDED