Android Auto messaging and calling integration

.github/workflows/android-auto-apk.yml

@@ -0,0 +1,131 @@
+name: Android Auto test APK
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - android-auto
+    paths:
+      - app/**
+      - build.gradle.kts
+      - settings.gradle.kts
+      - gradle/**
+      - gradle.properties
+      - .github/workflows/android-auto-apk.yml
+
+permissions: read-all
+
+concurrency:
+  group: android-auto-test-apk-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v6
+        with:
+          distribution: temurin
+          java-version: '21'
+
+      - name: Validate Gradle wrapper
+        uses: gradle/actions/wrapper-validation@v5
+
+      - name: Assemble standard GPlay debug APK
+        run: ./gradlew --no-daemon :app:assembleGplayDebug --stacktrace
+
+      - name: Stage standard APK
+        shell: bash
+        run: |
+          set -euo pipefail
+          python3 - <<'PY'
+          import json
+          from pathlib import Path
+          import shutil
+
+          output_dir = Path('app/build/outputs/apk/gplay/debug')
+          metadata = output_dir / 'output-metadata.json'
+          if not metadata.exists():
+              raise SystemExit('Standard output-metadata.json not found')
+
+          data = json.loads(metadata.read_text())
+          actual = data.get('applicationId')
+          expected = 'com.nextcloud.talk2'
+          print(f'Standard APK applicationId: {actual}')
+          if actual != expected:
+              raise SystemExit(f'Expected {expected}, got {actual}')
+
+          apks = list(output_dir.glob('*.apk'))
+          if len(apks) != 1:
+              raise SystemExit(f'Expected exactly one standard APK, found {len(apks)}')
+
+          destination = Path('dist/standard')
+          destination.mkdir(parents=True, exist_ok=True)
+          shutil.copy2(apks[0], destination / 'Nextcloud-Talk-Android-Auto-Gplay-Debug.apk')
+          (destination / 'package-id.txt').write_text(expected + '\n')
+          PY
+          (
+            cd dist/standard
+            sha256sum Nextcloud-Talk-Android-Auto-Gplay-Debug.apk > Nextcloud-Talk-Android-Auto-Gplay-Debug.apk.sha256
+          )
+
+      - name: Upload standard Android Auto APK
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: Nextcloud-Talk-Android-Auto-Gplay-Debug
+          path: dist/standard/*
+          if-no-files-found: error
+          retention-days: 14
+
+      - name: Clean before side-by-side build
+        run: ./gradlew --no-daemon :app:clean
+
+      - name: Assemble side-by-side GPlay debug APK
+        run: ./gradlew --no-daemon -PandroidAutoSideBySide=true :app:assembleGplayDebug --stacktrace
+
+      - name: Stage side-by-side APK
+        shell: bash
+        run: |
+          set -euo pipefail
+          python3 - <<'PY'
+          import json
+          from pathlib import Path
+          import shutil
+
+          output_dir = Path('app/build/outputs/apk/gplay/debug')
+          metadata = output_dir / 'output-metadata.json'
+          if not metadata.exists():
+              raise SystemExit('Side-by-side output-metadata.json not found')
+
+          data = json.loads(metadata.read_text())
+          actual = data.get('applicationId')
+          expected = 'com.nextcloud.talk2.auto'
+          print(f'Side-by-side APK applicationId: {actual}')
+          if actual != expected:
+              raise SystemExit(f'Expected {expected}, got {actual}')
+
+          apks = list(output_dir.glob('*.apk'))
+          if len(apks) != 1:
+              raise SystemExit(f'Expected exactly one side-by-side APK, found {len(apks)}')
+
+          destination = Path('dist/side-by-side')
+          destination.mkdir(parents=True, exist_ok=True)
+          shutil.copy2(apks[0], destination / 'Nextcloud-Talk-Android-Auto-Gplay-Debug-SideBySide.apk')
+          (destination / 'package-id.txt').write_text(expected + '\n')
+          PY
+          (
+            cd dist/side-by-side
+            sha256sum Nextcloud-Talk-Android-Auto-Gplay-Debug-SideBySide.apk > Nextcloud-Talk-Android-Auto-Gplay-Debug-SideBySide.apk.sha256
+          )
+
+      - name: Upload side-by-side Android Auto APK
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: Nextcloud-Talk-Android-Auto-Gplay-Debug-SideBySide
+          path: dist/side-by-side/*
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/android-auto-build.yml

@@ -0,0 +1,34 @@
+name: Android Auto build
+
+on:
+  push:
+    branches:
+      - android-auto
+  pull_request:
+    branches:
+      - master
+
+permissions:
+  contents: read
+
+concurrency:
+  group: android-auto-build-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  compile:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v6
+        with:
+          distribution: temurin
+          java-version: '21'
+
+      - name: Validate Gradle wrapper
+        uses: gradle/actions/wrapper-validation@v5
+
+      - name: Compile Google Play and generic flavors
+        run: ./gradlew :app:compileGplayDebugKotlin :app:compileGenericDebugKotlin --stacktrace

SETUP.md

@@ -106,6 +106,19 @@ This requires a working Internet connection.
 
 The generated APK file is saved in ```app/build/outputs/apk``` as ```app-generic-debug.apk```.
 
+### Working with Android Auto
+
+To test [notification extension to Android Auto](https://developer.android.com/training/cars/communication/notification-messaging), Developer settings and Unknown sources need to be enabled in 
+the Android Auto settings: 
+
+1. Open the Settings app on your device
+2. Search for Android Auto, or click on Connected Devices > Android Auto
+3. Scroll all the way down to Version, and click it 10 times to enable Developer settings
+4. Click the 3 dots in the top right and select Developer settings
+5. Enable Unknown sources
+
+You can now receive notifications on Android Auto from a Nextcloud Talk development build.
+
 ### App flavours
 
 The app is currently equipped to be built with three flavours:

app/build.gradle.kts

@@ -24,6 +24,9 @@ plugins {
 
 val kotlinVersion: String by rootProject.extra
 
+val androidAutoSideBySide =
+    providers.gradleProperty("androidAutoSideBySide").orNull == "true"
+
 val coilKtVersion = "2.7.0"
 val daggerVersion = "2.60.1"
 val emojiVersion = "1.6.0"
@@ -110,6 +113,13 @@ android {
     }
 
     buildTypes {
+        getByName("debug") {
+            if (androidAutoSideBySide) {
+                applicationIdSuffix = ".auto"
+                versionNameSuffix = "-auto"
+            }
+        }
+
         release {
             isMinifyEnabled = false
             proguardFiles(
@@ -194,6 +204,10 @@ configurations.configureEach {
 }
 
 dependencies {
+    // Android Auto communication UI is isolated to the Google Play flavor.
+    "gplayImplementation"("androidx.car.app:app:1.7.0")
+    "gplayImplementation"("androidx.car.app:app-projected:1.7.0")
+    "gplayImplementation"("androidx.core:core-telecom:1.1.0-alpha06")
     implementation("androidx.media3:media3-session:1.11.0")
     kapt("org.jetbrains.kotlin:kotlin-metadata-jvm:$kotlinVersion")
     implementation("androidx.room:room-testing-android:$roomVersion")

app/src/gplay/AndroidManifest.xml

@@ -9,6 +9,8 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
           xmlns:tools="http://schemas.android.com/tools">
 
+    <uses-permission android:name="android.permission.MANAGE_OWN_CALLS" />
+
     <application
         android:name=".application.NextcloudTalkApplication"
         android:allowBackup="true"
@@ -24,6 +26,40 @@
         <meta-data android:name="firebase_analytics_collection_deactivated" android:value="true" />
         <meta-data android:name="google_analytics_adid_collection_enabled" android:value="false" />
 
+
+        <!-- ConversationItem and communication templates require Car API 7. -->
+        <meta-data
+            android:name="androidx.car.app.minCarApiLevel"
+            android:value="7" />
+
+        <!-- Android Auto discovers the projected messaging capability through this descriptor. -->
+        <meta-data
+            android:name="com.google.android.gms.car.application"
+            android:resource="@xml/automotive_app_desc" />
+
+        <service
+            android:name=".auto.TalkCarAppService"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="androidx.car.app.CarAppService" />
+                <category android:name="androidx.car.app.category.MESSAGING" />
+                <category android:name="androidx.car.app.category.CALLING" />
+            </intent-filter>
+        </service>
+
+        <receiver
+            android:name=".auto.call.TalkTelecomInteropReceiver"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="com.nextcloud.talk.call.action.INCOMING" />
+                <action android:name="com.nextcloud.talk.call.action.STARTED" />
+                <action android:name="com.nextcloud.talk.call.action.ACTIVE" />
+                <action android:name="com.nextcloud.talk.call.action.ENDED" />
+                <action android:name="com.nextcloud.talk.call.action.PARTICIPANTS_CHANGED" />
+                <action android:name="com.nextcloud.talk.call.action.CONTROL_AUDIO_ENDPOINT" />
+            </intent-filter>
+        </receiver>
+
         <service
             android:name=".services.firebase.NCFirebaseMessagingService"
             android:exported="false">