add support for 'android:hasCode="false"'

Author: silbinarywolf

examples/minimal/android/AndroidManifest.xml

@@ -7,6 +7,7 @@
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
         android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
+        android:hasCode="false"
         tools:targetApi="31">
         <activity
             android:name="android.app.NativeActivity"

examples/minimal/android/src/NativeInvocationHandler.java

@@ -32,7 +32,9 @@ pub fn build(b: *std.Build) void {
         apk.addResourceDirectory(b.path("android/res"));
 
         // Add Java files
-        apk.addJavaSourceFile(.{ .file = b.path("android/src/NativeInvocationHandler.java") });
+        // - If you have 'android:hasCode="false"' in your AndroidManifest.xml then no Java files are required
+        //   see: https://developer.android.com/ndk/samples/sample_na
+        // apk.addJavaSourceFile(.{ .file = b.path("android/src/X.java") });
         break :blk apk;
     };
 

examples/minimal/build.zig

@@ -72,8 +72,16 @@ fn nativeActivityOnCreate(activity: *androidbind.ANativeActivity, savedState: []
     log.debug("Successfully started the app.", .{});
 }
 
+comptime {
+    if (builtin.abi.isAndroid()) {
+        @export(&NativeActivity_onCreate, .{ .name = "ANativeActivity_onCreate" });
+    } else {
+        @compileError("This example cannot run on targets other Android");
+    }
+}
+
 /// Android entry point
-export fn ANativeActivity_onCreate(activity: *androidbind.ANativeActivity, rawSavedState: ?[*]u8, rawSavedStateSize: usize) callconv(.C) void {
+fn NativeActivity_onCreate(activity: *androidbind.ANativeActivity, rawSavedState: ?[*]u8, rawSavedStateSize: usize) callconv(.C) void {
     const savedState: []const u8 = if (rawSavedState) |s|
         s[0..rawSavedStateSize]
     else

examples/minimal/src/minimal.zig

@@ -203,13 +203,18 @@ fn doInstallApk(apk: *Apk) std.mem.Allocator.Error!*Step.InstallFile {
                 }
             }
         }
-        if (apk.java_files.items.len == 0) {
-            // NOTE(jae): 2024-09-19
-            // We can probably avoid this with a stub or something but for now error so that an "adb install"
-            // doesn't give users:
-            // - Scanning Failed.: Package /data/app/base.apk code is missing]
-            try errors.append(b.fmt("must add at least one Java file to build", .{}));
-        }
+        // NOTE(jae): 2025-05-06
+        // This validation rule has been removed because if you have `android:hasCode="false"` in your AndroidManifest.xml file
+        // then you can have no Java files.
+        //
+        // If you do not provide Java files AND hasCode=false isn't set, then you may get the following error on "adb install"
+        // - Scanning Failed.: Package /data/app/base.apk code is missing]
+        //
+        // Ideally we may want to do something where we can utilize "aapt2 dump X" to determine if "hasCode" is set and if it isn't, throw
+        // an error at compilation time. Similar to how we use it to extract the package name from AndroidManifest.xml below (ie. "aapt2 dump packagename")
+        // if (apk.java_files.items.len == 0) {
+        //     try errors.append(b.fmt("must add at least one Java file to build OR you must setup your AndroidManifest.xml to have 'android:hasCode=false'", .{}));
+        // }
         if (errors.items.len > 0) {
             printErrorsAndExit("misconfigured Android APK", errors.items);
         }