Android.bp - platform/packages/modules/NetworkStack - Git at Google

 //
 // Copyright (C) 2018 The Android Open Source Project
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //      http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
 //

 // The network stack can be compiled using system_current (non-finalized) SDK, or finalized system_X
 // SDK. There is also a variant that uses system_current SDK and runs in the system process
 // (InProcessNetworkStack). The following structure is used to create the build rules:
 //
 //                          NetworkStackAndroidLibraryDefaults <-- common defaults for android libs
 //                                            /    \
 //           +NetworkStackApiStableShims --> /      \ <-- +NetworkStackApiCurrentShims
 //           +NetworkStackReleaseApiLevel   /        \    +NetworkStackDevApiLevel
 //           +jarjar apistub.api[latest].* /          \   +module src/
 //            to apistub.*                /            \
 //                                       /              \
 //         NetworkStackApiStableDependencies             \
 //                                     /                  \               android libs w/ all code
 //                   +module src/ --> /                    \              (also used in unit tests)
 //                                   /                      \                        |
 //               NetworkStackApiStableLib               NetworkStackApiCurrentLib <--*
 //                          |                                     |
 //                          | <--   +NetworkStackAppDefaults  --> |
 //                          |          (APK build params)         |
 //                          |                                     |
 //                          | <-- +NetworkStackReleaseApiLevel    | <-- +NetworkStackDevApiLevel
 //                          |                                     |
 //                          |                                     |
 //                NetworkStackApiStable          NetworkStack, InProcessNetworkStack, <-- APKs
 //                                                         TestNetworkStack

 // Common defaults to define SDK level
 java_defaults {
     name: "NetworkStackDevApiLevel",
     min_sdk_version: "29",
     sdk_version: "system_current",
 }

 java_defaults {
     name: "NetworkStackReleaseApiLevel",
     sdk_version: "system_30",
     min_sdk_version: "29",
     target_sdk_version: "30",
 }

 // Filegroups for the API shims
 filegroup {
     name: "NetworkStackApiCurrentShims",
     srcs: [
         "apishim/common/**/*.java",
         "apishim/29/**/*.java",
         "apishim/30/**/*.java",
         "apishim/31/**/*.java",
         ":networkstack-module-utils-srcs",
     ],
 }

 // API stable shims only include the compat package, but it is jarjared to replace the non-compat
 // package
 filegroup {
     name: "NetworkStackApiStableShims",
     srcs: [
         "apishim/common/**/*.java",
         "apishim/29/**/*.java",
         "apishim/30/**/*.java",
         ":networkstack-module-utils-srcs",
     ],
 }

 // Common defaults for android libraries containing network stack code, used to compile variants of
 // the network stack in the system process and in the network_stack process
 java_defaults {
     name: "NetworkStackAndroidLibraryDefaults",
     srcs: [
         ":framework-networkstack-shared-srcs",
     ],
     libs: ["unsupportedappusage"],
     static_libs: [
         "androidx.annotation_annotation",
         "netd_aidl_interface-unstable-java",
         "netlink-client",
         "networkstack-client",
         "net-utils-framework-common",
         // See note on statsprotos when adding/updating proto build rules
         "datastallprotosnano",
         "statsprotos",
         "captiveportal-lib",
         "net-utils-device-common",
     ],
     plugins: ["java_api_finder"],
 }

 // The versions of the android library containing network stack code compiled for each SDK variant
 // API current uses the sources of the API current shims directly.
 // This allows API current code to be treated identically to code in src/ (it will be moved
 // there eventually), and to use the compat shim as fallback on older devices.
 android_library {
     name: "NetworkStackApiCurrentLib",
     defaults: ["NetworkStackDevApiLevel", "NetworkStackAndroidLibraryDefaults"],
     srcs: [
         ":NetworkStackApiCurrentShims",
         "src/**/*.java",
         ":statslog-networkstack-java-gen"
     ],
     manifest: "AndroidManifestBase.xml",
 }

 // For API stable, first build the dependencies using jarjar compat rules, then build the sources
 // linking with the dependencies.
 java_library {
     name: "NetworkStackApiStableDependencies",
     defaults: ["NetworkStackReleaseApiLevel", "NetworkStackAndroidLibraryDefaults"],
     srcs: [":NetworkStackApiStableShims"],
     jarjar_rules: "apishim/jarjar-rules-compat.txt",
 }

 android_library {
     name: "NetworkStackApiStableLib",
     defaults: ["NetworkStackReleaseApiLevel"],
     srcs: [
         "src/**/*.java",
         ":statslog-networkstack-java-gen",
     ],
     // API stable uses a jarjared version of the shims
     static_libs: [
         "NetworkStackApiStableDependencies",
     ],
     manifest: "AndroidManifestBase.xml",
 }

 filegroup {
     name: "NetworkStackJarJarRules",
     srcs: ["jarjar-rules-shared.txt"],
     visibility: [
         "//packages/modules/NetworkStack/tests/unit",
         "//packages/modules/NetworkStack/tests/integration",
         "//frameworks/base/packages/Tethering/tests/integration",
         "//packages/modules/Connectivity/Tethering/tests/integration",
     ]
 }

 // Common defaults for compiling the actual APK, based on the NetworkStackApiXBase android libraries
 java_defaults {
     name: "NetworkStackAppDefaults",
     privileged: true,
     jni_libs: [
         "libnativehelper_compat_libc++",
         "libnetworkstackutilsjni",
     ],
     // Resources already included in NetworkStackBase
     resource_dirs: [],
     jarjar_rules: ":NetworkStackJarJarRules",
     use_embedded_native_libs: true,
     optimize: {
         proguard_flags_files: ["proguard.flags"],
     },
 }

 // Non-updatable network stack running in the system server process for devices not using the module
 android_app {
     name: "InProcessNetworkStack",
     defaults: [ "NetworkStackAppDefaults", "NetworkStackDevApiLevel"],
     static_libs: ["NetworkStackApiCurrentLib"],
     certificate: "platform",
     manifest: "AndroidManifest_InProcess.xml",
     // InProcessNetworkStack is a replacement for NetworkStack
     overrides: ["NetworkStack", "NetworkStackNext"],
     // The permission configuration *must* be included to ensure security of the device
     // The InProcessNetworkStack goes together with the PlatformCaptivePortalLogin, which replaces
     // the default CaptivePortalLogin.
     required: ["PlatformNetworkPermissionConfig", "PlatformCaptivePortalLogin"],
 }

 // Pre-merge the AndroidManifest for NetworkStackNext, so that its manifest can be merged on top
 android_library {
     name: "NetworkStackNextManifestBase",
     defaults: ["NetworkStackAppDefaults", "NetworkStackDevApiLevel"],
     static_libs: ["NetworkStackApiCurrentLib"],
     manifest: "AndroidManifest.xml"
 }

 // NetworkStack build targeting the current API release, for testing on in-development SDK
 android_app {
     name: "NetworkStackNext",
     defaults: ["NetworkStackAppDefaults", "NetworkStackDevApiLevel"],
     static_libs: ["NetworkStackNextManifestBase"],
     certificate: "networkstack",
     manifest: "AndroidManifest_Next.xml",
     // The permission configuration *must* be included to ensure security of the device
     required: ["NetworkPermissionConfig"],
 }

 // Updatable network stack for finalized API
 android_app {
     name: "NetworkStack",
     defaults: ["NetworkStackAppDefaults", "NetworkStackReleaseApiLevel"],
     static_libs: ["NetworkStackApiStableLib"],
     certificate: "networkstack",
     manifest: "AndroidManifest.xml",
     // The permission configuration *must* be included to ensure security of the device
     required: ["NetworkPermissionConfig"],
     updatable: true,
 }

 // Android library to derive test APKs for integration tests
 android_library {
     name: "TestNetworkStackLib",
     defaults: ["NetworkStackAppDefaults", "NetworkStackReleaseApiLevel"],
     static_libs: ["NetworkStackApiStableLib"],
     manifest: "AndroidManifestBase.xml",
     visibility: [
         "//frameworks/base/tests/net/integration",
         "//cts/tests/tests/net",
         "//packages/modules/Connectivity/tests/cts/net",
     ],
 }

 cc_library_shared {
     name: "libnetworkstackutilsjni",
     srcs: [
         "jni/network_stack_utils_jni.cpp"
     ],
     sdk_version: "29",
     min_sdk_version: "29",
     shared_libs: [
         "liblog",
         "libnativehelper_compat_libc++",
     ],
     static_libs: [
         "libnetjniutils",
     ],

     // We cannot use plain "libc++" here to link libc++ dynamically because it results in:
     //   java.lang.UnsatisfiedLinkError: dlopen failed: library "libc++_shared.so" not found
     // even if "libc++" is added into jni_libs below. Adding "libc++_shared" into jni_libs doesn't
     // build because soong complains of:
     //   module NetworkStack missing dependencies: libc++_shared
     //
     // So, link libc++ statically. This means that we also need to ensure that all the C++ libraries
     // we depend on do not dynamically link libc++. This is currently the case, because liblog is
     // C-only and libnativehelper_compat_libc also uses stl: "c++_static".
     //
     // TODO: find a better solution for this in R.
     stl: "c++_static",
     cflags: [
         "-Wall",
         "-Werror",
         "-Wno-unused-parameter",
     ],
 }

 genrule {
     name: "statslog-networkstack-java-gen",
     tools: ["stats-log-api-gen"],
     cmd: "$(location stats-log-api-gen) --java $(out) --module network_stack" +
          " --javaPackage com.android.networkstack.metrics --javaClass NetworkStackStatsLog" +
          " --supportQ",
     out: ["com/android/networkstack/metrics/NetworkStackStatsLog.java"],
 }

 version_code_networkstack_next = "300000000"
 version_code_networkstack_test = "999999999"

 genrule {
     name: "NetworkStackTestAndroidManifest",
     srcs: ["AndroidManifest.xml"],
     out: ["TestAndroidManifest.xml"],
     cmd: "sed -E 's/versionCode=\"[0-9]+\"/versionCode=\""
         + version_code_networkstack_test
         + "\"/' $(in) > $(out)",
     visibility: ["//visibility:private"],
 }

 android_app {
     name: "TestNetworkStack",
     defaults: ["NetworkStackAppDefaults", "NetworkStackDevApiLevel"],
     static_libs: ["NetworkStackApiCurrentLib"],
     certificate: "networkstack",
     manifest: ":NetworkStackTestAndroidManifest",
     // The permission configuration *must* be included to ensure security of the device
     required: ["NetworkPermissionConfig"],
 }

 // When adding or modifying protos, the jarjar rules and possibly proguard rules need
 // to be updated: proto libraries may pull additional static libraries.
 java_library_static {
     name: "statsprotos",
     proto: {
         type: "lite",
     },
     srcs: [
         "src/com/android/networkstack/metrics/stats.proto",
     ],
     static_libs: [
         "networkstackprotos",
     ],
     defaults: ["NetworkStackReleaseApiLevel"],
 }
	//
	// Copyright (C) 2018 The Android Open Source Project
	//
	// Licensed under the Apache License, Version 2.0 (the "License");
	// you may not use this file except in compliance with the License.
	// You may obtain a copy of the License at
	//
	// http://www.apache.org/licenses/LICENSE-2.0
	//
	// Unless required by applicable law or agreed to in writing, software
	// distributed under the License is distributed on an "AS IS" BASIS,
	// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	// See the License for the specific language governing permissions and
	// limitations under the License.
	//

	// The network stack can be compiled using system_current (non-finalized) SDK, or finalized system_X
	// SDK. There is also a variant that uses system_current SDK and runs in the system process
	// (InProcessNetworkStack). The following structure is used to create the build rules:
	//
	// NetworkStackAndroidLibraryDefaults <-- common defaults for android libs
	// / \
	// +NetworkStackApiStableShims --> / \ <-- +NetworkStackApiCurrentShims
	// +NetworkStackReleaseApiLevel / \ +NetworkStackDevApiLevel
	// +jarjar apistub.api[latest].* / \ +module src/
	// to apistub.* / \
	// / \
	// NetworkStackApiStableDependencies \
	// / \ android libs w/ all code
	// +module src/ --> / \ (also used in unit tests)
	// / \ \|
	// NetworkStackApiStableLib NetworkStackApiCurrentLib <--*
	// \| \|
	// \| <-- +NetworkStackAppDefaults --> \|
	// \| (APK build params) \|
	// \| \|
	// \| <-- +NetworkStackReleaseApiLevel \| <-- +NetworkStackDevApiLevel
	// \| \|
	// \| \|
	// NetworkStackApiStable NetworkStack, InProcessNetworkStack, <-- APKs
	// TestNetworkStack

	// Common defaults to define SDK level
	java_defaults {
	name: "NetworkStackDevApiLevel",
	min_sdk_version: "29",
	sdk_version: "system_current",
	}

	java_defaults {
	name: "NetworkStackReleaseApiLevel",
	sdk_version: "system_30",
	min_sdk_version: "29",
	target_sdk_version: "30",
	}

	// Filegroups for the API shims
	filegroup {
	name: "NetworkStackApiCurrentShims",
	srcs: [
	"apishim/common/*/.java",
	"apishim/29/*/.java",
	"apishim/30/*/.java",
	"apishim/31/*/.java",
	":networkstack-module-utils-srcs",
	],
	}

	// API stable shims only include the compat package, but it is jarjared to replace the non-compat
	// package
	filegroup {
	name: "NetworkStackApiStableShims",
	srcs: [
	"apishim/common/*/.java",
	"apishim/29/*/.java",
	"apishim/30/*/.java",
	":networkstack-module-utils-srcs",
	],
	}

	// Common defaults for android libraries containing network stack code, used to compile variants of
	// the network stack in the system process and in the network_stack process
	java_defaults {
	name: "NetworkStackAndroidLibraryDefaults",
	srcs: [
	":framework-networkstack-shared-srcs",
	],
	libs: ["unsupportedappusage"],
	static_libs: [
	"androidx.annotation_annotation",
	"netd_aidl_interface-unstable-java",
	"netlink-client",
	"networkstack-client",
	"net-utils-framework-common",
	// See note on statsprotos when adding/updating proto build rules
	"datastallprotosnano",
	"statsprotos",
	"captiveportal-lib",
	"net-utils-device-common",
	],
	plugins: ["java_api_finder"],
	}

	// The versions of the android library containing network stack code compiled for each SDK variant
	// API current uses the sources of the API current shims directly.
	// This allows API current code to be treated identically to code in src/ (it will be moved
	// there eventually), and to use the compat shim as fallback on older devices.
	android_library {
	name: "NetworkStackApiCurrentLib",
	defaults: ["NetworkStackDevApiLevel", "NetworkStackAndroidLibraryDefaults"],
	srcs: [
	":NetworkStackApiCurrentShims",
	"src/*/.java",
	":statslog-networkstack-java-gen"
	],
	manifest: "AndroidManifestBase.xml",
	}

	// For API stable, first build the dependencies using jarjar compat rules, then build the sources
	// linking with the dependencies.
	java_library {
	name: "NetworkStackApiStableDependencies",
	defaults: ["NetworkStackReleaseApiLevel", "NetworkStackAndroidLibraryDefaults"],
	srcs: [":NetworkStackApiStableShims"],
	jarjar_rules: "apishim/jarjar-rules-compat.txt",
	}

	android_library {
	name: "NetworkStackApiStableLib",
	defaults: ["NetworkStackReleaseApiLevel"],
	srcs: [
	"src/*/.java",
	":statslog-networkstack-java-gen",
	],
	// API stable uses a jarjared version of the shims
	static_libs: [
	"NetworkStackApiStableDependencies",
	],
	manifest: "AndroidManifestBase.xml",
	}

	filegroup {
	name: "NetworkStackJarJarRules",
	srcs: ["jarjar-rules-shared.txt"],
	visibility: [
	"//packages/modules/NetworkStack/tests/unit",
	"//packages/modules/NetworkStack/tests/integration",
	"//frameworks/base/packages/Tethering/tests/integration",
	"//packages/modules/Connectivity/Tethering/tests/integration",
	]
	}

	// Common defaults for compiling the actual APK, based on the NetworkStackApiXBase android libraries
	java_defaults {
	name: "NetworkStackAppDefaults",
	privileged: true,
	jni_libs: [
	"libnativehelper_compat_libc++",
	"libnetworkstackutilsjni",
	],
	// Resources already included in NetworkStackBase
	resource_dirs: [],
	jarjar_rules: ":NetworkStackJarJarRules",
	use_embedded_native_libs: true,
	optimize: {
	proguard_flags_files: ["proguard.flags"],
	},
	}

	// Non-updatable network stack running in the system server process for devices not using the module
	android_app {
	name: "InProcessNetworkStack",
	defaults: [ "NetworkStackAppDefaults", "NetworkStackDevApiLevel"],
	static_libs: ["NetworkStackApiCurrentLib"],
	certificate: "platform",
	manifest: "AndroidManifest_InProcess.xml",
	// InProcessNetworkStack is a replacement for NetworkStack
	overrides: ["NetworkStack", "NetworkStackNext"],
	// The permission configuration must be included to ensure security of the device
	// The InProcessNetworkStack goes together with the PlatformCaptivePortalLogin, which replaces
	// the default CaptivePortalLogin.
	required: ["PlatformNetworkPermissionConfig", "PlatformCaptivePortalLogin"],
	}

	// Pre-merge the AndroidManifest for NetworkStackNext, so that its manifest can be merged on top
	android_library {
	name: "NetworkStackNextManifestBase",
	defaults: ["NetworkStackAppDefaults", "NetworkStackDevApiLevel"],
	static_libs: ["NetworkStackApiCurrentLib"],
	manifest: "AndroidManifest.xml"
	}

	// NetworkStack build targeting the current API release, for testing on in-development SDK
	android_app {
	name: "NetworkStackNext",
	defaults: ["NetworkStackAppDefaults", "NetworkStackDevApiLevel"],
	static_libs: ["NetworkStackNextManifestBase"],
	certificate: "networkstack",
	manifest: "AndroidManifest_Next.xml",
	// The permission configuration must be included to ensure security of the device
	required: ["NetworkPermissionConfig"],
	}

	// Updatable network stack for finalized API
	android_app {
	name: "NetworkStack",
	defaults: ["NetworkStackAppDefaults", "NetworkStackReleaseApiLevel"],
	static_libs: ["NetworkStackApiStableLib"],
	certificate: "networkstack",
	manifest: "AndroidManifest.xml",
	// The permission configuration must be included to ensure security of the device
	required: ["NetworkPermissionConfig"],
	updatable: true,
	}

	// Android library to derive test APKs for integration tests
	android_library {
	name: "TestNetworkStackLib",
	defaults: ["NetworkStackAppDefaults", "NetworkStackReleaseApiLevel"],
	static_libs: ["NetworkStackApiStableLib"],
	manifest: "AndroidManifestBase.xml",
	visibility: [
	"//frameworks/base/tests/net/integration",
	"//cts/tests/tests/net",
	"//packages/modules/Connectivity/tests/cts/net",
	],
	}

	cc_library_shared {
	name: "libnetworkstackutilsjni",
	srcs: [
	"jni/network_stack_utils_jni.cpp"
	],
	sdk_version: "29",
	min_sdk_version: "29",
	shared_libs: [
	"liblog",
	"libnativehelper_compat_libc++",
	],
	static_libs: [
	"libnetjniutils",
	],

	// We cannot use plain "libc++" here to link libc++ dynamically because it results in:
	// java.lang.UnsatisfiedLinkError: dlopen failed: library "libc++_shared.so" not found
	// even if "libc++" is added into jni_libs below. Adding "libc++_shared" into jni_libs doesn't
	// build because soong complains of:
	// module NetworkStack missing dependencies: libc++_shared
	//
	// So, link libc++ statically. This means that we also need to ensure that all the C++ libraries
	// we depend on do not dynamically link libc++. This is currently the case, because liblog is
	// C-only and libnativehelper_compat_libc also uses stl: "c++_static".
	//
	// TODO: find a better solution for this in R.
	stl: "c++_static",
	cflags: [
	"-Wall",
	"-Werror",
	"-Wno-unused-parameter",
	],
	}

	genrule {
	name: "statslog-networkstack-java-gen",
	tools: ["stats-log-api-gen"],
	cmd: "$(location stats-log-api-gen) --java $(out) --module network_stack" +
	" --javaPackage com.android.networkstack.metrics --javaClass NetworkStackStatsLog" +
	" --supportQ",
	out: ["com/android/networkstack/metrics/NetworkStackStatsLog.java"],
	}

	version_code_networkstack_next = "300000000"
	version_code_networkstack_test = "999999999"

	genrule {
	name: "NetworkStackTestAndroidManifest",
	srcs: ["AndroidManifest.xml"],
	out: ["TestAndroidManifest.xml"],
	cmd: "sed -E 's/versionCode=\"[0-9]+\"/versionCode=\""
	+ version_code_networkstack_test
	+ "\"/' $(in) > $(out)",
	visibility: ["//visibility:private"],
	}

	android_app {
	name: "TestNetworkStack",
	defaults: ["NetworkStackAppDefaults", "NetworkStackDevApiLevel"],
	static_libs: ["NetworkStackApiCurrentLib"],
	certificate: "networkstack",
	manifest: ":NetworkStackTestAndroidManifest",
	// The permission configuration must be included to ensure security of the device
	required: ["NetworkPermissionConfig"],
	}

	// When adding or modifying protos, the jarjar rules and possibly proguard rules need
	// to be updated: proto libraries may pull additional static libraries.
	java_library_static {
	name: "statsprotos",
	proto: {
	type: "lite",
	},
	srcs: [
	"src/com/android/networkstack/metrics/stats.proto",
	],
	static_libs: [
	"networkstackprotos",
	],
	defaults: ["NetworkStackReleaseApiLevel"],
	}