Add build target for NetworkStack on API 29

NetworkStack will need at least two different build targets: one for the
in-progress SDK for testing before release, and one for the latest
released SDK for releasing to production.

The difference in available APIs is abstracted from the core code by
using shims, with one shim for the released SDK that uses fallback code,
and one shim for the in-progress SDK that calls the actual new API.
The shim included in the built code depends on the build target.

AOSP does not yet have prebuilts for API 29, so the build rule still
references system_current for now.

Test: atest NetworkStackTests
Test: flashed, WiFi working
Test: aapt dump xmltree NetworkStack.apk AndroidManifest.xml: no change
Test: m NetworkStackApiStable (on a branch that has the prebuilt SDK)
Change-Id: I9cf8e712b56a8aad8656eb5095ac8a32f4a05037
diff --git a/Android.bp b/Android.bp
index 2e71c75..ba2e424 100644
--- a/Android.bp
+++ b/Android.bp
@@ -14,6 +14,26 @@
 // 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
+//    +NetworkStackApiStableLevel    /               \    +NetworkStackApiCurrentLevel
+//                                  /                 \
+//           NetworkStackApiStableLib         NetworkStackApiCurrentLib <-- android libs w/ all code
+//                     |                                     |             (also used in unit tests)
+//                     | <--   +NetworkStackAppDefaults  --> |
+//                     |          (APK build params)         |
+//                     |                                     |
+//                     | <-- +NetworkStackApiStableLevel     | <-- +NetworkStackApiCurrentLevel
+//                     |                                     |
+//                     |                                     |
+//           NetworkStackApiStable          NetworkStack, InProcessNetworkStack, <-- output APKs
+//                                                    TestNetworkStack
+
 java_library {
     name: "captiveportal-lib",
     srcs: ["common/**/*.java"],
@@ -23,16 +43,38 @@
     sdk_version: "system_current",
 }
 
+// Common defaults to define SDK level
 java_defaults {
-    name: "NetworkStackCommon",
+    name: "NetworkStackApiCurrentLevel",
     sdk_version: "system_current",
     min_sdk_version: "28",
 }
 
-// Library including the network stack, used to compile both variants of the network stack
-android_library {
-    name: "NetworkStackBase",
-    defaults: ["NetworkStackCommon"],
+java_defaults {
+    name: "NetworkStackApiStableLevel",
+    sdk_version: "system_current", // TODO: change to system_29
+    min_sdk_version: "28",
+}
+
+// Java libraries for the API shims
+filegroup {
+    name: "NetworkStackApiCurrentShims",
+    srcs: [
+        "apishim/current/**/*.java"
+    ],
+}
+
+filegroup {
+    name: "NetworkStackApiStableShims",
+    srcs: [
+        "apishim/29/**/*.java"
+    ],
+}
+
+// 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: [
         "src/**/*.java",
         ":framework-networkstack-shared-srcs",
@@ -51,6 +93,85 @@
     manifest: "AndroidManifestBase.xml",
 }
 
+// The versions of the android library containing network stack code compiled for each SDK variant
+android_library {
+    name: "NetworkStackApiCurrentLib",
+    defaults: ["NetworkStackApiCurrentLevel", "NetworkStackAndroidLibraryDefaults"],
+    srcs: [
+        ":NetworkStackApiCurrentShims",
+    ],
+}
+
+android_library {
+    name: "NetworkStackApiStableLib",
+    defaults: ["NetworkStackApiStableLevel", "NetworkStackAndroidLibraryDefaults"],
+    srcs: [
+        ":NetworkStackApiStableShims",
+    ],
+}
+
+// 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: "jarjar-rules-shared.txt",
+    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", "NetworkStackApiCurrentLevel"],
+    static_libs: ["NetworkStackApiCurrentLib"],
+    certificate: "platform",
+    manifest: "AndroidManifest_InProcess.xml",
+    // InProcessNetworkStack is a replacement for NetworkStack
+    overrides: ["NetworkStack"],
+    // 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"],
+}
+
+// Updatable network stack packaged as an application
+android_app {
+    name: "NetworkStack",
+    defaults: ["NetworkStackAppDefaults", "NetworkStackApiCurrentLevel"],
+    static_libs: ["NetworkStackApiCurrentLib"],
+    certificate: "networkstack",
+    manifest: "AndroidManifest.xml",
+    // The permission configuration *must* be included to ensure security of the device
+    required: ["NetworkPermissionConfig"],
+}
+
+// Updatable network stack for finalized API
+android_app {
+    name: "NetworkStackApiStable",
+    defaults: ["NetworkStackAppDefaults", "NetworkStackApiStableLevel"],
+    static_libs: ["NetworkStackApiStableLib"],
+    certificate: "networkstack",
+    manifest: "AndroidManifest.xml",
+    // The permission configuration *must* be included to ensure security of the device
+    required: ["NetworkPermissionConfig"],
+}
+
+// Android library to derive test APKs for integration tests
+android_library {
+    name: "TestNetworkStackLib",
+    defaults: ["NetworkStackAppDefaults", "NetworkStackApiCurrentLevel"],
+    static_libs: ["NetworkStackApiCurrentLib"],
+    manifest: "AndroidManifest.xml",
+}
+
 cc_library_shared {
     name: "libnetworkstackutilsjni",
     srcs: [
@@ -81,56 +202,6 @@
     ],
 }
 
-java_defaults {
-    name: "NetworkStackAppCommon",
-    defaults: ["NetworkStackCommon"],
-    privileged: true,
-    static_libs: [
-        "NetworkStackBase",
-    ],
-    jni_libs: [
-        "libnativehelper_compat_libc++",
-        "libnetworkstackutilsjni",
-    ],
-    // Resources already included in NetworkStackBase
-    resource_dirs: [],
-    jarjar_rules: "jarjar-rules-shared.txt",
-    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: ["NetworkStackAppCommon"],
-    certificate: "platform",
-    manifest: "AndroidManifest_InProcess.xml",
-    // InProcessNetworkStack is a replacement for NetworkStack
-    overrides: ["NetworkStack"],
-    // 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"],
-}
-
-// Updatable network stack packaged as an application
-android_app {
-    name: "NetworkStack",
-    defaults: ["NetworkStackAppCommon"],
-    certificate: "networkstack",
-    manifest: "AndroidManifest.xml",
-    use_embedded_native_libs: true,
-    // The permission configuration *must* be included to ensure security of the device
-    required: ["NetworkPermissionConfig"],
-}
-
-android_library {
-    name: "TestNetworkStackLib",
-    defaults: ["NetworkStackAppCommon"],
-    manifest: "AndroidManifest.xml",
-}
-
 genrule {
     name: "statslog-networkstack-java-gen",
     tools: ["stats-log-api-gen"],
@@ -148,11 +219,10 @@
 
 android_app {
     name: "TestNetworkStack",
-    defaults: ["NetworkStackAppCommon"],
+    defaults: ["NetworkStackAppDefaults", "NetworkStackApiCurrentLevel"],
+    static_libs: ["NetworkStackApiCurrentLib"],
     certificate: "networkstack",
     manifest: ":NetworkStackTestAndroidManifest",
-    use_embedded_native_libs: true,
     // The permission configuration *must* be included to ensure security of the device
     required: ["NetworkPermissionConfig"],
 }
-