blob: b745db0c42a346c14ac353149c3912c6b4c43a52 [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 Cross943e2aa2017-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 Wasilczyk347192e2017-04-04 11:13:44 -0700105 frameworks/base/core/java/android/hardware/radio/RadioManager.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000106 frameworks/base/core/java/android/hardware/usb/UsbDevice.aidl \
107 frameworks/base/core/java/android/hardware/usb/UsbInterface.aidl \
108 frameworks/base/core/java/android/hardware/usb/UsbEndpoint.aidl \
109 frameworks/base/core/java/android/hardware/usb/UsbAccessory.aidl \
110 frameworks/base/core/java/android/os/Messenger.aidl \
111 frameworks/base/core/java/android/os/PatternMatcher.aidl \
112 frameworks/base/core/java/android/os/Message.aidl \
113 frameworks/base/core/java/android/os/UserHandle.aidl \
114 frameworks/base/core/java/android/os/ParcelUuid.aidl \
115 frameworks/base/core/java/android/os/ParcelFileDescriptor.aidl \
116 frameworks/base/core/java/android/os/ResultReceiver.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000117 frameworks/base/core/java/android/os/WorkSource.aidl \
118 frameworks/base/core/java/android/os/DropBoxManager.aidl \
119 frameworks/base/core/java/android/os/Bundle.aidl \
Sudheer Shankacc6418f2016-10-13 12:03:44 -0700120 frameworks/base/core/java/android/os/Debug.aidl \
Sudheer Shankafc46e9b2016-10-21 17:55:27 -0700121 frameworks/base/core/java/android/os/StrictMode.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000122 frameworks/base/core/java/android/accessibilityservice/AccessibilityServiceInfo.aidl \
123 frameworks/base/core/java/android/net/Network.aidl \
124 frameworks/base/core/java/android/net/RouteInfo.aidl \
125 frameworks/base/core/java/android/net/NetworkInfo.aidl \
126 frameworks/base/core/java/android/net/IpPrefix.aidl \
127 frameworks/base/core/java/android/net/NetworkCapabilities.aidl \
128 frameworks/base/core/java/android/net/DhcpInfo.aidl \
129 frameworks/base/core/java/android/net/ProxyInfo.aidl \
130 frameworks/base/core/java/android/net/LinkProperties.aidl \
131 frameworks/base/core/java/android/net/Uri.aidl \
132 frameworks/base/core/java/android/net/NetworkRequest.aidl \
133 frameworks/base/core/java/android/net/LinkAddress.aidl \
Svet Ganov53a441c2016-04-19 19:38:00 -0700134 frameworks/base/core/java/android/util/MemoryIntArray.aidl \
P.Y. Laligandb3b9eb32015-05-11 15:02:07 -0700135 frameworks/base/core/java/android/view/Display.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000136 frameworks/base/core/java/android/view/InputDevice.aidl \
137 frameworks/base/core/java/android/view/InputEvent.aidl \
Eino-Ville Talvala5d2d7782015-12-17 16:50:50 -0800138 frameworks/native/aidl/gui/android/view/Surface.aidl \
P.Y. Laligandb3b9eb32015-05-11 15:02:07 -0700139 frameworks/base/core/java/android/view/WindowContentFrameStats.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000140 frameworks/base/core/java/android/view/inputmethod/InputMethodSubtype.aidl \
141 frameworks/base/core/java/android/view/inputmethod/CursorAnchorInfo.aidl \
142 frameworks/base/core/java/android/view/inputmethod/CompletionInfo.aidl \
143 frameworks/base/core/java/android/view/inputmethod/ExtractedText.aidl \
144 frameworks/base/core/java/android/view/inputmethod/EditorInfo.aidl \
145 frameworks/base/core/java/android/view/inputmethod/InputMethodInfo.aidl \
146 frameworks/base/core/java/android/view/inputmethod/CorrectionInfo.aidl \
147 frameworks/base/core/java/android/view/inputmethod/InputBinding.aidl \
148 frameworks/base/core/java/android/view/inputmethod/ExtractedTextRequest.aidl \
149 frameworks/base/core/java/android/view/DragEvent.aidl \
150 frameworks/base/core/java/android/view/KeyEvent.aidl \
151 frameworks/base/core/java/android/view/WindowManager.aidl \
152 frameworks/base/core/java/android/view/WindowAnimationFrameStats.aidl \
153 frameworks/base/core/java/android/view/MotionEvent.aidl \
154 frameworks/base/core/java/android/view/accessibility/AccessibilityNodeInfo.aidl \
155 frameworks/base/core/java/android/view/accessibility/AccessibilityRecord.aidl \
156 frameworks/base/core/java/android/view/accessibility/AccessibilityWindowInfo.aidl \
157 frameworks/base/core/java/android/view/accessibility/AccessibilityEvent.aidl \
158 frameworks/base/core/java/android/view/textservice/SpellCheckerSubtype.aidl \
159 frameworks/base/core/java/android/view/textservice/TextInfo.aidl \
160 frameworks/base/core/java/android/view/textservice/SpellCheckerInfo.aidl \
161 frameworks/base/core/java/android/view/textservice/SentenceSuggestionsInfo.aidl \
162 frameworks/base/core/java/android/view/textservice/SuggestionsInfo.aidl \
163 frameworks/base/core/java/android/service/carrier/CarrierIdentifier.aidl \
164 frameworks/base/core/java/android/service/carrier/MessagePdu.aidl \
Jeff Davidson91c3d072017-04-12 12:17:11 -0700165 frameworks/base/core/java/android/service/euicc/GetDefaultDownloadableSubscriptionListResult.aidl \
Jeff Davidson35cda392017-02-27 09:46:00 -0800166 frameworks/base/core/java/android/service/euicc/GetDownloadableSubscriptionMetadataResult.aidl \
Jeff Davidsond02731f2017-04-09 14:31:09 -0700167 frameworks/base/core/java/android/service/euicc/GetEuiccProfileInfoListResult.aidl \
Julia Reynolds22f02b32016-12-01 15:05:13 -0500168 frameworks/base/core/java/android/service/notification/Adjustment.aidl \
169 frameworks/base/core/java/android/service/notification/Condition.aidl \
170 frameworks/base/core/java/android/service/notification/SnoozeCriterion.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000171 frameworks/base/core/java/android/service/notification/StatusBarNotification.aidl \
172 frameworks/base/core/java/android/service/chooser/ChooserTarget.aidl \
Kang Libbced1c2017-04-05 12:30:55 -0700173 frameworks/base/core/java/android/service/resolver/ResolverTarget.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000174 frameworks/base/core/java/android/speech/tts/Voice.aidl \
Daniel Nishicf9d19e2017-01-23 14:33:42 -0800175 frameworks/base/core/java/android/app/usage/CacheQuotaHint.aidl \
Jeff Sharkey8dedad32017-01-09 18:21:21 -0700176 frameworks/base/core/java/android/app/usage/ExternalStorageStats.aidl \
Jeff Sharkeye8cece92017-01-04 11:33:33 -0700177 frameworks/base/core/java/android/app/usage/StorageStats.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000178 frameworks/base/core/java/android/app/usage/UsageEvents.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000179 frameworks/base/core/java/android/app/Notification.aidl \
180 frameworks/base/core/java/android/app/NotificationManager.aidl \
181 frameworks/base/core/java/android/app/WallpaperInfo.aidl \
182 frameworks/base/core/java/android/app/AppOpsManager.aidl \
183 frameworks/base/core/java/android/app/ActivityManager.aidl \
184 frameworks/base/core/java/android/app/PendingIntent.aidl \
185 frameworks/base/core/java/android/app/AlarmManager.aidl \
186 frameworks/base/core/java/android/app/SearchableInfo.aidl \
187 frameworks/base/core/java/android/app/VoiceInteractor.aidl \
Dianne Hackborn69c6adc2015-06-02 10:52:59 -0700188 frameworks/base/core/java/android/app/assist/AssistContent.aidl \
189 frameworks/base/core/java/android/app/assist/AssistStructure.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000190 frameworks/base/core/java/android/app/job/JobParameters.aidl \
191 frameworks/base/core/java/android/app/job/JobInfo.aidl \
192 frameworks/base/core/java/android/appwidget/AppWidgetProviderInfo.aidl \
193 frameworks/base/core/java/android/content/ClipDescription.aidl \
194 frameworks/base/core/java/android/content/IntentFilter.aidl \
195 frameworks/base/core/java/android/content/Intent.aidl \
196 frameworks/base/core/java/android/content/res/Configuration.aidl \
197 frameworks/base/core/java/android/content/res/ObbInfo.aidl \
198 frameworks/base/core/java/android/content/RestrictionEntry.aidl \
199 frameworks/base/core/java/android/content/ClipData.aidl \
200 frameworks/base/core/java/android/content/SyncAdapterType.aidl \
201 frameworks/base/core/java/android/content/SyncRequest.aidl \
202 frameworks/base/core/java/android/content/PeriodicSync.aidl \
203 frameworks/base/core/java/android/content/SyncResult.aidl \
204 frameworks/base/core/java/android/content/pm/FeatureInfo.aidl \
205 frameworks/base/core/java/android/content/pm/InstrumentationInfo.aidl \
206 frameworks/base/core/java/android/content/pm/PackageInstaller.aidl \
207 frameworks/base/core/java/android/content/pm/ServiceInfo.aidl \
208 frameworks/base/core/java/android/content/pm/Signature.aidl \
209 frameworks/base/core/java/android/content/pm/ApplicationInfo.aidl \
210 frameworks/base/core/java/android/content/pm/PermissionInfo.aidl \
211 frameworks/base/core/java/android/content/pm/ActivityInfo.aidl \
Sudheer Shankafc46e9b2016-10-21 17:55:27 -0700212 frameworks/base/core/java/android/content/pm/ConfigurationInfo.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000213 frameworks/base/core/java/android/content/pm/PackageInfo.aidl \
214 frameworks/base/core/java/android/content/pm/ResolveInfo.aidl \
215 frameworks/base/core/java/android/content/pm/ProviderInfo.aidl \
216 frameworks/base/core/java/android/content/pm/PackageStats.aidl \
217 frameworks/base/core/java/android/content/pm/PermissionGroupInfo.aidl \
Makoto Onuki6f7362d92016-03-04 13:39:41 -0800218 frameworks/base/core/java/android/content/pm/ShortcutInfo.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000219 frameworks/base/core/java/android/content/pm/LabeledIntent.aidl \
220 frameworks/base/core/java/android/content/ComponentName.aidl \
221 frameworks/base/core/java/android/content/SyncStats.aidl \
222 frameworks/base/core/java/android/content/ContentValues.aidl \
223 frameworks/base/core/java/android/content/SyncInfo.aidl \
224 frameworks/base/core/java/android/content/IntentSender.aidl \
225 frameworks/base/core/java/android/widget/RemoteViews.aidl \
226 frameworks/base/core/java/android/text/style/SuggestionSpan.aidl \
227 frameworks/base/core/java/android/nfc/Tag.aidl \
228 frameworks/base/core/java/android/nfc/NdefRecord.aidl \
229 frameworks/base/core/java/android/nfc/NdefMessage.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000230 frameworks/base/core/java/android/database/CursorWindow.aidl \
Jason Monkbbadff82015-11-06 15:47:26 -0500231 frameworks/base/core/java/android/service/quicksettings/Tile.aidl \
Samuel Tan239951a2016-01-05 17:29:43 -0800232 frameworks/native/aidl/binder/android/os/PersistableBundle.aidl \
Jakub Pawlowski3b38eaa2017-08-09 00:45:34 -0700233 system/bt/binder/android/bluetooth/BluetoothHealthAppConfiguration.aidl \
234 system/bt/binder/android/bluetooth/le/AdvertiseSettings.aidl \
235 system/bt/binder/android/bluetooth/le/ScanSettings.aidl \
236 system/bt/binder/android/bluetooth/le/AdvertiseData.aidl \
237 system/bt/binder/android/bluetooth/le/ScanFilter.aidl \
238 system/bt/binder/android/bluetooth/le/ScanResult.aidl \
239 system/bt/binder/android/bluetooth/BluetoothDevice.aidl \
Robin Lee10606942016-03-30 18:52:40 +0100240 system/netd/server/binder/android/net/UidRange.aidl \
Robert Greenwalt37409c52016-06-02 13:43:27 -0700241 frameworks/base/telephony/java/android/telephony/PcoData.aidl \
Bart Searsa8cc0582015-05-07 03:23:20 +0000242
243gen := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl
244$(gen): PRIVATE_SRC_FILES := $(aidl_files)
245ALL_SDK_FILES += $(gen)
246$(gen): $(aidl_files) | $(AIDL)
247 @echo Aidl Preprocess: $@
248 $(hide) $(AIDL) --preprocess $@ $(PRIVATE_SRC_FILES)
249
250# the documentation
251# ============================================================
252
253# TODO: deal with com/google/android/googleapps
254packages_to_document := \
Colin Cross943e2aa2017-11-16 00:15:28 -0800255 android \
256 javax/microedition/khronos \
257 org/apache/http/conn \
258 org/apache/http/params \
Bart Searsa8cc0582015-05-07 03:23:20 +0000259
260# include definition of libcore_to_document
261include libcore/Docs.mk
262
Bart Searsa8cc0582015-05-07 03:23:20 +0000263non_base_dirs := \
Colin Cross943e2aa2017-11-16 00:15:28 -0800264 ../opt/telephony/src/java/android/telephony \
265 ../opt/telephony/src/java/android/telephony/gsm \
266 ../opt/net/voip/src/java/android/net/rtp \
267 ../opt/net/voip/src/java/android/net/sip \
Bart Searsa8cc0582015-05-07 03:23:20 +0000268
Colin Cross943e2aa2017-11-16 00:15:28 -0800269# Find all files in specific directories (relative to frameworks/base)
270# to document and check apis
271files_to_check_apis := \
272 $(call find-other-java-files, \
273 legacy-test/src \
274 test-runner/src \
275 $(non_base_dirs) \
276 )
Bart Searsa8cc0582015-05-07 03:23:20 +0000277
Colin Cross943e2aa2017-11-16 00:15:28 -0800278# Find all files in specific packages that were used to compile
279# framework.jar to document and check apis
280files_to_check_apis += \
281 $(addprefix ../../,\
282 $(filter \
283 $(foreach dir,$(FRAMEWORKS_BASE_JAVA_SRC_DIRS),\
284 $(foreach package,$(packages_to_document),\
285 $(dir)/$(package)/%.java)),\
286 $(SOONG_FRAMEWORK_SRCS)))
287
288# Find all generated files that were used to compile framework.jar
Colin Cross0c760952017-12-04 13:45:19 -0800289files_to_check_apis_generated := \
290 $(filter $(OUT_DIR)/%,\
291 $(SOONG_FRAMEWORK_SRCS))
George Mountf6be9932015-12-03 07:39:55 -0800292
Bart Searsa8cc0582015-05-07 03:23:20 +0000293# These are relative to frameworks/base
294# FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk
Colin Cross943e2aa2017-11-16 00:15:28 -0800295files_to_document := \
296 $(files_to_check_apis) \
297 $(call find-other-java-files,$(addprefix ../../, $(FRAMEWORKS_DATA_BINDING_JAVA_SRC_DIRS)))
George Mountf6be9932015-12-03 07:39:55 -0800298
Bart Searsa8cc0582015-05-07 03:23:20 +0000299# These are relative to frameworks/base
300html_dirs := \
301 $(FRAMEWORKS_BASE_SUBDIRS) \
Colin Cross943e2aa2017-11-16 00:15:28 -0800302 $(non_base_dirs) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000303
304# Common sources for doc check and api check
305common_src_files := \
306 $(call find-other-html-files, $(html_dirs)) \
Colin Cross943e2aa2017-11-16 00:15:28 -0800307 $(addprefix ../../, $(libcore_to_document)) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000308
309# These are relative to frameworks/base
310framework_docs_LOCAL_SRC_FILES := \
Colin Cross943e2aa2017-11-16 00:15:28 -0800311 $(files_to_document) \
312 $(common_src_files) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000313
314# These are relative to frameworks/base
315framework_docs_LOCAL_API_CHECK_SRC_FILES := \
Colin Cross943e2aa2017-11-16 00:15:28 -0800316 $(files_to_check_apis) \
317 $(common_src_files) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000318
319# This is used by ide.mk as the list of source files that are
320# always included.
321INTERNAL_SDK_SOURCE_DIRS := $(addprefix $(LOCAL_PATH)/,$(dirs_to_document))
322
323framework_docs_LOCAL_DROIDDOC_SOURCE_PATH := \
324 $(FRAMEWORKS_BASE_JAVA_SRC_DIRS)
325
Colin Cross943e2aa2017-11-16 00:15:28 -0800326framework_docs_LOCAL_SRCJARS := $(SOONG_FRAMEWORK_SRCJARS)
327
Colin Cross0c760952017-12-04 13:45:19 -0800328framework_docs_LOCAL_GENERATED_SOURCES := \
329 $(libcore_to_document_generated) \
330 $(files_to_check_apis_generated) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000331
332framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES := \
Piotr Jastrzebskicfa292e2015-02-17 16:58:52 +0000333 core-oj \
Bart Searsa8cc0582015-05-07 03:23:20 +0000334 core-libart \
335 conscrypt \
336 bouncycastle \
337 okhttp \
338 ext \
Rayhaan Jaufeerally2e47a6e2015-08-03 13:54:28 +0100339 icu4j \
Bart Searsa8cc0582015-05-07 03:23:20 +0000340 framework \
Bart Searsa8cc0582015-05-07 03:23:20 +0000341 voip-common
342
Alan Viverette2d362a52017-04-05 10:21:58 -0400343# Platform docs can refer to Support Library APIs, but we don't actually build
344# them as part of the docs target, so we need to include them on the classpath.
Bart Searsa8cc0582015-05-07 03:23:20 +0000345framework_docs_LOCAL_JAVA_LIBRARIES := \
346 $(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES) \
347 $(FRAMEWORKS_SUPPORT_JAVA_LIBRARIES)
348
349framework_docs_LOCAL_MODULE_CLASS := JAVA_LIBRARIES
350framework_docs_LOCAL_DROIDDOC_HTML_DIR := docs/html
351# The since flag (-since N.xml API_LEVEL) is used to add API Level information
352# to the reference documentation. Must be in order of oldest to newest.
353#
354# Conscrypt (com.android.org.conscrypt) is an implementation detail and should
355# not be referenced in the documentation.
356framework_docs_LOCAL_DROIDDOC_OPTIONS := \
Jeff Sharkey0f3f60b2017-04-24 18:06:20 -0600357 -android \
Bart Searsa8cc0582015-05-07 03:23:20 +0000358 -knowntags ./frameworks/base/docs/knowntags.txt \
Narayan Kamath2c4f2842015-07-27 14:02:11 +0100359 -knowntags ./libcore/known_oj_tags.txt \
Jeff Sharkeybfc4fcd2017-06-05 17:38:17 -0600360 -manifest ./frameworks/base/core/res/AndroidManifest.xml \
Bart Searsa8cc0582015-05-07 03:23:20 +0000361 -hidePackage com.android.org.conscrypt \
362 -since $(SRC_API_DIR)/1.xml 1 \
363 -since $(SRC_API_DIR)/2.xml 2 \
364 -since $(SRC_API_DIR)/3.xml 3 \
365 -since $(SRC_API_DIR)/4.xml 4 \
366 -since $(SRC_API_DIR)/5.xml 5 \
367 -since $(SRC_API_DIR)/6.xml 6 \
368 -since $(SRC_API_DIR)/7.xml 7 \
369 -since $(SRC_API_DIR)/8.xml 8 \
370 -since $(SRC_API_DIR)/9.xml 9 \
371 -since $(SRC_API_DIR)/10.xml 10 \
372 -since $(SRC_API_DIR)/11.xml 11 \
373 -since $(SRC_API_DIR)/12.xml 12 \
374 -since $(SRC_API_DIR)/13.xml 13 \
375 -since $(SRC_API_DIR)/14.txt 14 \
376 -since $(SRC_API_DIR)/15.txt 15 \
377 -since $(SRC_API_DIR)/16.txt 16 \
378 -since $(SRC_API_DIR)/17.txt 17 \
379 -since $(SRC_API_DIR)/18.txt 18 \
380 -since $(SRC_API_DIR)/19.txt 19 \
381 -since $(SRC_API_DIR)/20.txt 20 \
382 -since $(SRC_API_DIR)/21.txt 21 \
383 -since $(SRC_API_DIR)/22.txt 22 \
Joe Fernandez1827e322015-08-12 19:45:22 -0700384 -since $(SRC_API_DIR)/23.txt 23 \
Dirk Dougherty5f60f7c2016-06-14 16:26:28 -0700385 -since $(SRC_API_DIR)/24.txt 24 \
Dirk Dougherty3376f582016-10-14 10:27:08 -0700386 -since $(SRC_API_DIR)/25.txt 25 \
Dirk Doughertyfdad0ba2017-06-09 14:43:32 -0700387 -since $(SRC_API_DIR)/26.txt 26 \
Jeff Sharkey0f3f60b2017-04-24 18:06:20 -0600388 -werror -hide 111 -hide 113 -hide 121 \
389 -overview $(LOCAL_PATH)/core/java/overview.html \
Bart Searsa8cc0582015-05-07 03:23:20 +0000390
391framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR:= \
392 $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)
393
394framework_docs_LOCAL_ADDITIONAL_JAVA_DIR:= \
Alan Viverette2d362a52017-04-05 10:21:58 -0400395 $(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
Bart Searsa8cc0582015-05-07 03:23:20 +0000396
397framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES := \
Narayan Kamathc21739a2015-07-14 13:39:23 +0100398 frameworks/base/docs/knowntags.txt \
Colin Cross72d359f2017-10-27 10:46:53 -0700399 $(libcore_to_document_generated)
Bart Searsa8cc0582015-05-07 03:23:20 +0000400
401samples_dir := development/samples/browseable
402
403# Whitelist of valid groups, used for default TOC grouping. Each sample must
404# belong to one (and only one) group. Assign samples to groups by setting
405# a sample.group var to one of these groups in the sample's _index.jd.
406sample_groups := -samplegroup Admin \
407 -samplegroup Background \
408 -samplegroup Connectivity \
409 -samplegroup Content \
410 -samplegroup Input \
411 -samplegroup Media \
412 -samplegroup Notification \
413 -samplegroup RenderScript \
414 -samplegroup Security \
415 -samplegroup Sensors \
Trevor Johns4cbe3592015-05-27 14:50:51 -0700416 -samplegroup System \
Bart Searsa8cc0582015-05-07 03:23:20 +0000417 -samplegroup Testing \
418 -samplegroup UI \
419 -samplegroup Views \
420 -samplegroup Wearable
421
422## SDK version identifiers used in the published docs
423 # major[.minor] version for current SDK. (full releases only)
smain@google.comdde8deb2016-08-29 18:36:50 -0700424framework_docs_SDK_VERSION:=7.0
Bart Searsa8cc0582015-05-07 03:23:20 +0000425 # release version (ie "Release x") (full releases only)
426framework_docs_SDK_REL_ID:=1
427
428framework_docs_LOCAL_DROIDDOC_OPTIONS += \
Billy Lamberta75dbc8f2017-03-03 13:09:15 -0800429 -hdf dac true \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700430 -hdf sdk.codename O \
431 -hdf sdk.preview.version 1 \
Bart Searsa8cc0582015-05-07 03:23:20 +0000432 -hdf sdk.version $(framework_docs_SDK_VERSION) \
433 -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700434 -hdf sdk.preview 0 \
435 -resourcesdir $(LOCAL_PATH)/docs/html/reference/images/ \
436 -resourcesoutdir reference/android/images/
Bart Searsa8cc0582015-05-07 03:23:20 +0000437
Alan Viverette2d362a52017-04-05 10:21:58 -0400438# Federate Support Library references against local API file.
439framework_docs_LOCAL_DROIDDOC_OPTIONS += \
440 -federate SupportLib https://developer.android.com \
441 -federationapi SupportLib prebuilts/sdk/current/support-api.txt
442
Bart Searsa8cc0582015-05-07 03:23:20 +0000443# ==== the api stubs and current.xml ===========================
444include $(CLEAR_VARS)
445
446LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800447LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800448LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000449LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
450LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
451LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
452LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
453LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
454LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
455
456LOCAL_MODULE := api-stubs
457
Ying Wang0f92a2e2015-07-16 14:20:22 -0700458LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_stubs_current_intermediates/src
459
Bart Searsa8cc0582015-05-07 03:23:20 +0000460LOCAL_DROIDDOC_OPTIONS:=\
461 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700462 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000463 -api $(INTERNAL_PLATFORM_API_FILE) \
464 -removedApi $(INTERNAL_PLATFORM_REMOVED_API_FILE) \
465 -nodocs
466
Scott Main15b85172017-02-21 14:30:58 -0800467LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000468
469LOCAL_UNINSTALLABLE_MODULE := true
470
471include $(BUILD_DROIDDOC)
472
473# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
Colin Cross943e2aa2017-11-16 00:15:28 -0800474$(full_target): $(gen)
Bart Searsa8cc0582015-05-07 03:23:20 +0000475$(INTERNAL_PLATFORM_API_FILE): $(full_target)
476$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_API_FILE))
477
478# ==== the system api stubs ===================================
479include $(CLEAR_VARS)
480
481LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800482LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800483LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000484LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
485LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
486LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
487LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
488LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
489LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
490
491LOCAL_MODULE := system-api-stubs
492
Ying Wang0f92a2e2015-07-16 14:20:22 -0700493LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_system_stubs_current_intermediates/src
494
Bart Searsa8cc0582015-05-07 03:23:20 +0000495LOCAL_DROIDDOC_OPTIONS:=\
496 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700497 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000498 -showAnnotation android.annotation.SystemApi \
499 -api $(INTERNAL_PLATFORM_SYSTEM_API_FILE) \
500 -removedApi $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) \
Jeff Sharkey05461c02017-05-09 19:01:09 -0600501 -exactApi $(INTERNAL_PLATFORM_SYSTEM_EXACT_API_FILE) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000502 -nodocs
503
Scott Main15b85172017-02-21 14:30:58 -0800504LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000505
506LOCAL_UNINSTALLABLE_MODULE := true
507
508include $(BUILD_DROIDDOC)
509
510# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
Colin Cross943e2aa2017-11-16 00:15:28 -0800511$(full_target): $(gen)
Bart Searsa8cc0582015-05-07 03:23:20 +0000512$(INTERNAL_PLATFORM_SYSTEM_API_FILE): $(full_target)
513$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_SYSTEM_API_FILE))
514
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000515# ==== the test api stubs ===================================
516include $(CLEAR_VARS)
517
518LOCAL_SRC_FILES:=$(framework_docs_LOCAL_API_CHECK_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800519LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800520LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000521LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_API_CHECK_JAVA_LIBRARIES)
522LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
523LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
524LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
525LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_API_CHECK_ADDITIONAL_JAVA_DIR)
526LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
527
528LOCAL_MODULE := test-api-stubs
529
530LOCAL_DROIDDOC_STUB_OUT_DIR := $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src
531
532LOCAL_DROIDDOC_OPTIONS:=\
533 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700534 -referenceonly \
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000535 -stubs $(TARGET_OUT_COMMON_INTERMEDIATES)/JAVA_LIBRARIES/android_test_stubs_current_intermediates/src \
536 -showAnnotation android.annotation.TestApi \
537 -api $(INTERNAL_PLATFORM_TEST_API_FILE) \
538 -removedApi $(INTERNAL_PLATFORM_TEST_REMOVED_API_FILE) \
Jeff Sharkey05461c02017-05-09 19:01:09 -0600539 -exactApi $(INTERNAL_PLATFORM_TEST_EXACT_API_FILE) \
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000540 -nodocs
541
Scott Main15b85172017-02-21 14:30:58 -0800542LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000543
544LOCAL_UNINSTALLABLE_MODULE := true
545
546include $(BUILD_DROIDDOC)
547
548# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
Colin Cross943e2aa2017-11-16 00:15:28 -0800549$(full_target): $(gen)
Michael Wrightb2b2c0e2015-11-06 15:21:13 +0000550$(INTERNAL_PLATFORM_TEST_API_FILE): $(full_target)
551$(call dist-for-goals,sdk,$(INTERNAL_PLATFORM_TEST_API_FILE))
552
Bart Searsa8cc0582015-05-07 03:23:20 +0000553# ==== check javadoc comments but don't generate docs ========
554include $(CLEAR_VARS)
555
556LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800557LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800558LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000559LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
560LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
561LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
562LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
563LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
564LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
565
566LOCAL_MODULE := doc-comment-check
567
568LOCAL_DROIDDOC_OPTIONS:=\
569 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700570 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000571 -parsecomments
572
Scott Main15b85172017-02-21 14:30:58 -0800573LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000574
575LOCAL_UNINSTALLABLE_MODULE := true
576
577include $(BUILD_DROIDDOC)
578
579# $(gen), i.e. framework.aidl, is also needed while building against the current stub.
Colin Cross943e2aa2017-11-16 00:15:28 -0800580$(full_target): $(gen)
Bart Searsa8cc0582015-05-07 03:23:20 +0000581
582# Run this for checkbuild
583checkbuild: doc-comment-check-docs
584# Check comment when you are updating the API
585update-api: doc-comment-check-docs
586
587# ==== static html in the sdk ==================================
588include $(CLEAR_VARS)
589
590LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800591LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800592LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000593LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
594LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
595LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
596LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
597LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
598LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
599
600LOCAL_MODULE := offline-sdk
601
602LOCAL_DROIDDOC_OPTIONS:=\
603 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
604 -offlinemode \
605 -title "Android SDK" \
606 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
smain@google.com00de8c52016-03-07 18:38:08 -0800607 -sdkvalues $(OUT_DOCS) \
smain@google.com8562ab52016-06-14 17:11:57 -0700608 -hdf android.whichdoc offline
609
Scott Main15b85172017-02-21 14:30:58 -0800610LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
smain@google.com8562ab52016-06-14 17:11:57 -0700611
612include $(BUILD_DROIDDOC)
613
614static_doc_index_redirect := $(out_dir)/index.html
615$(static_doc_index_redirect): \
616 $(LOCAL_PATH)/docs/docs-preview-index.html | $(ACP)
617 $(hide) mkdir -p $(dir $@)
618 $(hide) $(ACP) $< $@
619
620$(full_target): $(static_doc_index_redirect)
smain@google.com8562ab52016-06-14 17:11:57 -0700621
622
623# ==== static html in the sdk ==================================
624include $(CLEAR_VARS)
625
626LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800627LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800628LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
smain@google.com8562ab52016-06-14 17:11:57 -0700629LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
630LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
631LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
632LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
633LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
634LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
635
636LOCAL_MODULE := offline-sdk-referenceonly
637
638LOCAL_DROIDDOC_OPTIONS:=\
639 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
640 -offlinemode \
641 -title "Android SDK" \
642 -proofread $(OUT_DOCS)/$(LOCAL_MODULE)-proofread.txt \
643 -sdkvalues $(OUT_DOCS) \
smain@google.com00de8c52016-03-07 18:38:08 -0800644 -hdf android.whichdoc offline \
Scott Mainf8cdfc82017-03-21 13:43:31 -0700645 -referenceonly
smain@google.com00de8c52016-03-07 18:38:08 -0800646
Scott Main15b85172017-02-21 14:30:58 -0800647LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
smain@google.com00de8c52016-03-07 18:38:08 -0800648
649include $(BUILD_DROIDDOC)
650
651static_doc_index_redirect := $(out_dir)/index.html
smain@google.com151833a2016-08-31 08:42:09 -0700652$(static_doc_index_redirect): $(LOCAL_PATH)/docs/docs-documentation-redirect.html
Dan Willemsen98ff0b72016-03-23 00:42:44 -0700653 $(copy-file-to-target)
smain@google.com00de8c52016-03-07 18:38:08 -0800654
smain@google.com2f2365d2016-09-21 14:05:50 -0700655static_doc_properties := $(out_dir)/source.properties
656$(static_doc_properties): \
657 $(LOCAL_PATH)/docs/source.properties | $(ACP)
658 $(hide) mkdir -p $(dir $@)
659 $(hide) $(ACP) $< $@
660
smain@google.com00de8c52016-03-07 18:38:08 -0800661$(full_target): $(static_doc_index_redirect)
smain@google.com2f2365d2016-09-21 14:05:50 -0700662$(full_target): $(static_doc_properties)
smain@google.com00de8c52016-03-07 18:38:08 -0800663
smain@google.com7aca8be2016-03-10 14:13:30 -0800664
Bart Searsa8cc0582015-05-07 03:23:20 +0000665# ==== docs for the web (on the androiddevdocs app engine server) =======================
666include $(CLEAR_VARS)
667
668LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800669LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800670LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000671LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
672LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
673LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
674LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
675LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
676LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
677LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
678LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
679
680LOCAL_MODULE := online-sdk
681
682LOCAL_DROIDDOC_OPTIONS:= \
683 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
684 -toroot / \
685 -hdf android.whichdoc online \
686 $(sample_groups) \
687 -hdf android.hasSamples true \
688 -samplesdir $(samples_dir)
689
Scott Main15b85172017-02-21 14:30:58 -0800690LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000691
692include $(BUILD_DROIDDOC)
693
694# ==== docs for the web (on the androiddevdocs app engine server) =======================
Bart Searsa8cc0582015-05-07 03:23:20 +0000695include $(CLEAR_VARS)
696
697LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800698LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800699LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000700LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
701LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
702LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
703LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
704LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
705LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
706LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
707LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
708
709LOCAL_MODULE := online-system-api-sdk
710
711LOCAL_DROIDDOC_OPTIONS:= \
712 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700713 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000714 -showAnnotation android.annotation.SystemApi \
715 -title "Android SDK - Including system APIs." \
716 -toroot / \
Gina Dimino98ad8882016-05-31 17:25:48 -0700717 -hide 101 \
718 -hide 104 \
719 -hide 108 \
Bart Searsa8cc0582015-05-07 03:23:20 +0000720 -hdf android.whichdoc online \
721 $(sample_groups) \
722 -hdf android.hasSamples true \
723 -samplesdir $(samples_dir)
724
Scott Main15b85172017-02-21 14:30:58 -0800725LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Jeff Sharkey05461c02017-05-09 19:01:09 -0600726
Bart Searsa8cc0582015-05-07 03:23:20 +0000727LOCAL_UNINSTALLABLE_MODULE := true
728
729include $(BUILD_DROIDDOC)
Bart Searsa8cc0582015-05-07 03:23:20 +0000730
731# ==== docs for the web (on the devsite app engine server) =======================
732include $(CLEAR_VARS)
733LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800734LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800735LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000736LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
737LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
738LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
739LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
740LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
741LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
742LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
743# specify a second html input dir and an output path relative to OUT_DIR)
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700744LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
Bart Searsa8cc0582015-05-07 03:23:20 +0000745
746LOCAL_MODULE := ds
747
748LOCAL_DROIDDOC_OPTIONS:= \
749 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
Bart Searsa8cc0582015-05-07 03:23:20 +0000750 -toroot / \
751 -hdf android.whichdoc online \
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700752 -devsite \
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700753 $(sample_groups) \
Dirk Dougherty3852c1f2016-04-10 02:05:09 -0700754 -hdf android.hasSamples true \
755 -samplesdir $(samples_dir)
Bart Searsa8cc0582015-05-07 03:23:20 +0000756
Scott Main15b85172017-02-21 14:30:58 -0800757LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000758
759include $(BUILD_DROIDDOC)
760
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700761# ==== docs for the web (on the devsite app engine server) =======================
762include $(CLEAR_VARS)
763LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800764LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800765LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700766LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
767LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
768LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
769LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
770LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
771LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
772LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
773# specify a second html input dir and an output path relative to OUT_DIR)
774LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
775
776LOCAL_MODULE := ds-static
777
778LOCAL_DROIDDOC_OPTIONS:= \
779 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
780 -hdf android.whichdoc online \
781 -staticonly \
782 -toroot / \
783 -devsite \
784 -ignoreJdLinks
785
Scott Main15b85172017-02-21 14:30:58 -0800786LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Dirk Doughertyb042ab12016-06-14 16:26:28 -0700787
788include $(BUILD_DROIDDOC)
789
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700790# ==== generates full navtree for resolving @links in ds postprocessing ====
791include $(CLEAR_VARS)
792
793LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800794LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800795LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700796LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
797LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
798LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
799LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
800LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
801LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
802
803LOCAL_MODULE := ds-ref-navtree
804
805LOCAL_DROIDDOC_OPTIONS:= \
806 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
807 -hdf android.whichdoc online \
808 -toroot / \
809 -atLinksNavtree \
810 -navtreeonly
811
Scott Main15b85172017-02-21 14:30:58 -0800812LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Dirk Dougherty7d47b552016-09-13 16:44:25 -0700813
814include $(BUILD_DROIDDOC)
815
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800816# ==== site updates for docs (on the androiddevdocs app engine server) =======================
Bart Searsa8cc0582015-05-07 03:23:20 +0000817include $(CLEAR_VARS)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800818
Bart Searsa8cc0582015-05-07 03:23:20 +0000819LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800820LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800821LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000822LOCAL_STATIC_JAVA_LIBRARIES:=$(framework_docs_LOCAL_STATIC_JAVA_LIBRARIES)
823LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
824LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
825LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800826LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
Bart Searsa8cc0582015-05-07 03:23:20 +0000827LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
828LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800829LOCAL_ADDITIONAL_HTML_DIR:=docs/html-intl /
Bart Searsa8cc0582015-05-07 03:23:20 +0000830
Dirk Dougherty31ae1c512015-11-07 13:18:02 -0800831LOCAL_MODULE := online-sdk-dev
Bart Searsa8cc0582015-05-07 03:23:20 +0000832
833LOCAL_DROIDDOC_OPTIONS:= \
834 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
835 -toroot / \
836 -hdf android.whichdoc online \
837 $(sample_groups) \
838 -hdf android.hasSamples true \
839 -samplesdir $(samples_dir)
840
Scott Main15b85172017-02-21 14:30:58 -0800841LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000842
843include $(BUILD_DROIDDOC)
844
Bart Searsa8cc0582015-05-07 03:23:20 +0000845# ==== docs that have all of the stuff that's @hidden =======================
846include $(CLEAR_VARS)
847
848LOCAL_SRC_FILES:=$(framework_docs_LOCAL_SRC_FILES)
Colin Cross0c760952017-12-04 13:45:19 -0800849LOCAL_GENERATED_SOURCES:=$(framework_docs_LOCAL_GENERATED_SOURCES)
Colin Cross943e2aa2017-11-16 00:15:28 -0800850LOCAL_SRCJARS:=$(framework_docs_LOCAL_SRCJARS)
Bart Searsa8cc0582015-05-07 03:23:20 +0000851LOCAL_JAVA_LIBRARIES:=$(framework_docs_LOCAL_JAVA_LIBRARIES)
852LOCAL_MODULE_CLASS:=$(framework_docs_LOCAL_MODULE_CLASS)
853LOCAL_DROIDDOC_SOURCE_PATH:=$(framework_docs_LOCAL_DROIDDOC_SOURCE_PATH)
854LOCAL_DROIDDOC_HTML_DIR:=$(framework_docs_LOCAL_DROIDDOC_HTML_DIR)
855LOCAL_ADDITIONAL_JAVA_DIR:=$(framework_docs_LOCAL_ADDITIONAL_JAVA_DIR)
856LOCAL_ADDITIONAL_DEPENDENCIES:=$(framework_docs_LOCAL_ADDITIONAL_DEPENDENCIES)
857
858LOCAL_MODULE := hidden
859LOCAL_DROIDDOC_OPTIONS:=\
860 $(framework_docs_LOCAL_DROIDDOC_OPTIONS) \
smain@google.com534bfe12016-09-01 19:52:17 -0700861 -referenceonly \
Bart Searsa8cc0582015-05-07 03:23:20 +0000862 -title "Android SDK - Including hidden APIs."
863# -hidden
864
Scott Main15b85172017-02-21 14:30:58 -0800865LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=external/doclava/res/assets/templates-sdk
Bart Searsa8cc0582015-05-07 03:23:20 +0000866
867include $(BUILD_DROIDDOC)
868
Joe Onorato1754d742016-11-21 17:51:35 -0800869# ==== java proto host library ==============================
870include $(CLEAR_VARS)
871LOCAL_MODULE := platformprotos
872LOCAL_PROTOC_OPTIMIZE_TYPE := full
873LOCAL_PROTOC_FLAGS := \
874 -Iexternal/protobuf/src
875LOCAL_SOURCE_FILES_ALL_GENERATED := true
876LOCAL_SRC_FILES := \
877 $(call all-proto-files-under, core/proto) \
878 $(call all-proto-files-under, libs/incident/proto)
879include $(BUILD_HOST_JAVA_LIBRARY)
880
Bart Searsa8cc0582015-05-07 03:23:20 +0000881
882# Include subdirectory makefiles
883# ============================================================
884
885# If we're building with ONE_SHOT_MAKEFILE (mm, mmm), then what the framework
886# team really wants is to build the stuff defined by this makefile.
887ifeq (,$(ONE_SHOT_MAKEFILE))
888include $(call first-makefiles-under,$(LOCAL_PATH))
889endif
890
891endif # ANDROID_BUILD_EMBEDDED