Merge "Pass previously released API when generating framework doc stubs" into main (ab104e29) · Commits · e / os / android_frameworks_base

api/ApiDocs.bp

+31 −1

Original line number	Diff line number	Diff line
		@@ -129,6 +129,10 @@ droidstubs {
		droidstubs {
		name: "framework-doc-stubs",
		defaults: ["android-non-updatable-doc-stubs-defaults"],
		flags: [
		// Ignore any compatibility errors, see check_api.last_released below for more information.
		"--hide-category Compatibility",
		],
		srcs: [":all-modules-public-stubs-source-exportable"],
		api_levels_module: "api_versions_public",
		aidl: {
		@@ -137,13 +141,39 @@ droidstubs {
		"packages/modules/Media/apex/aidl/stable",
		],
		},

		// Pass the previously released API to support reverting flagged APIs. Without this, reverting
		// a flagged API will cause it to be removed, even if it had previously been released. This
		// has the side effect of causing compatibility issues to be reported but they are already
		// checked elsewhere so they will be ignored, see `--hide-category Compatibility` above.
		check_api: {
		last_released: {
		api_file: ":android.api.combined.public.latest",
		removed_api_file: ":android-removed.api.combined.public.latest",
		},
		},
		}

		droidstubs {
		name: "framework-doc-system-stubs",
		defaults: ["framework-doc-stubs-sources-default"],
		flags: ["--show-annotation android.annotation.SystemApi\\(client=android.annotation.SystemApi.Client.PRIVILEGED_APPS\\)"],
		flags: [
		"--show-annotation android.annotation.SystemApi\\(client=android.annotation.SystemApi.Client.PRIVILEGED_APPS\\)",
		// Ignore any compatibility errors, see check_api.last_released below for more information.
		"--hide-category Compatibility",
		],
		api_levels_module: "api_versions_system",

		// Pass the previously released API to support reverting flagged APIs. Without this, reverting
		// a flagged API will cause it to be removed, even if it had previously been released. This
		// has the side effect of causing compatibility issues to be reported but they are already
		// checked elsewhere so they will be ignored, see `--hide-category Compatibility` above.
		check_api: {
		last_released: {
		api_file: ":android.api.combined.system.latest",
		removed_api_file: ":android-removed.api.combined.system.latest",
		},
		},
		}

		/////////////////////////////////////////////////////////////////////