Scaffold a minimal Android starter app

.github/workflows/android-ci.yml

@@ -0,0 +1,43 @@
+name: Android CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up JDK
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "17"
+          cache: gradle
+
+      - name: Set up Android SDK
+        uses: android-actions/setup-android@v3
+
+      - name: Accept Android SDK licenses
+        run: yes | sdkmanager --licenses >/dev/null
+
+      - name: Install Android 36 packages
+        run: sdkmanager "platforms;android-36" "build-tools;36.0.0"
+
+      - name: Make Gradle wrapper executable
+        run: chmod +x ./gradlew
+
+      - name: Run unit tests
+        run: ./gradlew --no-daemon testDebugUnitTest
+
+      - name: Assemble debug app
+        run: ./gradlew --no-daemon assembleDebug

README.md

@@ -1,2 +1,30 @@
 # MyAndroidApp
-A simple Android app using Retrofit
+
+MyAndroidApp is now a minimal Android starter project written in Java.
+
+It is intentionally small:
+
+- one `Activity`
+- no Retrofit wiring yet
+- no Compose dependency yet
+- a GitHub Actions workflow that runs the basic unit test task and assembles the debug app
+
+## Build
+
+```bash
+./gradlew assembleDebug
+```
+
+## Test
+
+```bash
+./gradlew testDebugUnitTest
+```
+
+## Run
+
+Open the project in Android Studio or install the generated debug APK from a machine with the Android SDK configured.
+
+## CI
+
+GitHub Actions runs both `testDebugUnitTest` and `assembleDebug` on pushes and pull requests to `main`.

app/build.gradle.kts

@@ -0,0 +1,35 @@
+plugins {
+    alias(libs.plugins.android.application)
+}
+
+android {
+    namespace = "io.github.aeewws.myandroidapp"
+    compileSdk = 36
+
+    defaultConfig {
+        applicationId = "io.github.aeewws.myandroidapp"
+        minSdk = 26
+        targetSdk = 36
+        versionCode = 1
+        versionName = "0.1.0"
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_11
+        targetCompatibility = JavaVersion.VERSION_11
+    }
+}
+
+dependencies {
+    testImplementation("junit:junit:4.13.2")
+}

app/proguard-rules.pro

@@ -0,0 +1 @@
+# Minimal starter project: keep the release rules intentionally empty for now.

app/src/main/AndroidManifest.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application
+        android:allowBackup="true"
+        android:label="@string/app_name"
+        android:supportsRtl="true">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

app/src/main/java/io/github/aeewws/myandroidapp/MainActivity.java

@@ -0,0 +1,19 @@
+package io.github.aeewws.myandroidapp;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.widget.TextView;
+
+public final class MainActivity extends Activity {
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+
+        TextView label = new TextView(this);
+        label.setText("MyAndroidApp starter");
+        label.setTextSize(22f);
+        label.setPadding(48, 96, 48, 96);
+
+        setContentView(label);
+    }
+}

app/src/main/res/values/strings.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">MyAndroidApp</string>
+</resources>

app/src/test/java/io/github/aeewws/myandroidapp/ExampleUnitTest.java

@@ -0,0 +1,12 @@
+package io.github.aeewws.myandroidapp;
+
+import org.junit.Test;
+
+import static org.junit.Assert.assertEquals;
+
+public final class ExampleUnitTest {
+    @Test
+    public void launcherLabelIsStable() {
+        assertEquals("MyAndroidApp starter", "MyAndroidApp starter");
+    }
+}

build.gradle.kts

@@ -0,0 +1,3 @@
+plugins {
+    alias(libs.plugins.android.application) apply false
+}

gradle.properties

@@ -0,0 +1,5 @@
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+android.useAndroidX=true
+kotlin.code.style=official
+android.nonTransitiveRClass=true
+android.overridePathCheck=true

gradle/libs.versions.toml

@@ -0,0 +1,5 @@
+[versions]
+agp = "9.0.0"
+
+[plugins]
+android-application = { id = "com.android.application", version.ref = "agp" }

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,9 @@
+#Wed Feb 04 11:51:17 CST 2026
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionSha256Sum=a17ddd85a26b6a7f5ddb71ff8b05fc5104c0202c6e64782429790c933686c806
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists