Partial RCS support: Constellation, Asterism, and testing documentation

PR_DESCRIPTION.md

@@ -0,0 +1,33 @@
+
+# Partial RCS Support: Constellation, Asterism, and Testing Documentation
+
+## Summary
+
+This PR provides partial RCS support groundwork for microG by integrating the existing Constellation and Asterism work and adding structured documentation for build/testing status.
+
+## Included
+
+- Integrated Constellation Service work from PR #3359
+- Integrated Asterism Service work from PR #3360
+- Added RCS implementation status documentation
+- Added RCS testing notes and diagnostic workflow
+
+## Current Status
+
+This PR does not fully solve RCS support yet.
+
+The current branch provides partial implementation groundwork. Full RCS message transmission is not yet confirmed.
+
+## Remaining Work
+
+- Tachyon registration support
+- DroidGuard challenge compatibility analysis
+- Real-device RCS testing
+- Message sending and receiving verification
+- Locked bootloader verification
+
+## Relation to Issue
+
+Related to #2994.
+
+This PR should not be treated as a complete fix yet. It is intended to help move RCS implementation forward with a clearer implementation and testing baseline.

RCS_IMPLEMENTATION_STATUS.md

@@ -0,0 +1,33 @@
+# RCS Implementation Status for microG
+
+## Status
+Partial RCS implementation support.
+
+## Integrated Work
+- Constellation Service integrated from PR #3359
+- Asterism Service integrated from PR #3360
+- Basic RCS-related implementation groundwork is now available in this branch
+
+## Current Build Status
+Build attempt was performed using:
+
+./gradlew assembleDebug
+
+Current result:
+FAILED due to Java compiler toolchain configuration issue.
+
+This is an environment/build configuration issue, not a confirmed RCS runtime failure.
+
+## Remaining Work
+- Tachyon registration support
+- DroidGuard challenge compatibility analysis
+- Actual RCS message sending and receiving
+- End-to-end testing on a real Android device with active SIM
+- Locked bootloader verification as required by the bounty
+
+## Important Note
+This branch does not fully solve Issue #2994 yet.
+
+It provides partial implementation groundwork by integrating existing Constellation and Asterism work, and adds structured documentation for testing and future completion.
+
+Related to #2994.

RCS_TESTING_NOTES.md

@@ -0,0 +1,39 @@
+# RCS Testing Notes
+
+## Environment
+- Repository: microg/GmsCore fork
+- Branch: rcs-support
+- Integrated PRs:
+  - PR #3359 Constellation Service
+  - PR #3360 Asterism Service
+
+## Build Attempt
+
+Command:
+
+./gradlew assembleDebug
+
+Result:
+
+FAILED
+
+Known issue:
+
+Java compiler toolchain configuration issue.
+
+## Required Testing Device
+Full RCS testing requires:
+
+- Physical Android device
+- Active SIM card
+- Google Messages installed
+- Locked bootloader
+- microG GmsCore built and installed
+- Required phone, SMS, contacts, and network permissions granted
+
+## Suggested Logcat Commands
+
+```bash
+adb logcat | grep -iE "rcs|tachyon|constellation|asterism|provisioning"
+adb logcat | grep -i "google.android.apps.messaging"
+adb logcat | grep -iE "auth|verification|droidguard"

play-services-asterism/build.gradle

@@ -0,0 +1,40 @@
+/*
+ * SPDX-FileCopyrightText: 2026, microG Project Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply plugin: 'signing'
+
+android {
+    namespace "org.microg.gms.asterism"
+
+    compileSdkVersion androidCompileSdk
+    buildToolsVersion "$androidBuildVersionTools"
+
+    buildFeatures {
+        aidl = true
+    }
+
+    defaultConfig {
+        versionName version
+        minSdkVersion androidMinSdk
+        targetSdkVersion androidTargetSdk
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+}
+
+apply from: '../gradle/publish-android.gradle'
+
+description = 'microG implementation of play-services-asterism'
+
+dependencies {
+    implementation project(':play-services-basement')
+
+    annotationProcessor project(":safe-parcel-processor")
+}

play-services-asterism/core/build.gradle

@@ -0,0 +1,46 @@
+/*
+ * SPDX-FileCopyrightText: 2026, microG Project Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply plugin: 'kotlin-android'
+apply plugin: 'signing'
+
+android {
+    namespace "org.microg.gms.asterism.core"
+
+    compileSdkVersion androidCompileSdk
+    buildToolsVersion "$androidBuildVersionTools"
+
+    defaultConfig {
+        versionName version
+        minSdkVersion androidMinSdk
+        targetSdkVersion androidTargetSdk
+    }
+
+    sourceSets {
+        main.java.srcDirs += 'src/main/kotlin'
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    kotlinOptions {
+        jvmTarget = 1.8
+    }
+}
+
+apply from: '../../gradle/publish-android.gradle'
+
+description = 'microG service implementation for play-services-asterism'
+
+dependencies {
+    api project(':play-services-asterism')
+
+    implementation project(':play-services-base-core')
+    implementation project(':play-services-constellation-core')
+}

play-services-asterism/core/src/main/AndroidManifest.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?><!--
+  ~ SPDX-FileCopyrightText: 2026, microG Project Team
+  ~ SPDX-License-Identifier: Apache-2.0
+  -->
+
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application>
+        <service android:name=".AsterismApiService">
+            <intent-filter>
+                <action android:name="com.google.android.gms.asterism.service.START" />
+            </intent-filter>
+        </service>
+    </application>
+</manifest>

play-services-asterism/core/src/main/kotlin/com/google/android/gms/asterism/GetAsterismConsent.kt

@@ -0,0 +1,31 @@
+package com.google.android.gms.asterism
+
+import org.microg.gms.constellation.core.proto.AsterismClient
+import org.microg.gms.constellation.core.proto.Consent
+import org.microg.gms.constellation.core.proto.ConsentVersion
+
+val GetAsterismConsentRequest.asterismClient: AsterismClient
+    get() = AsterismClient.fromValue(asterismClientValue) ?: AsterismClient.UNKNOWN_CLIENT
+
+fun getAsterismConsentResponse(
+    requestCode: Int,
+    consentState: Consent,
+    gmscoreIidToken: String?,
+    fid: String?,
+    consentVersion: ConsentVersion
+): GetAsterismConsentResponse {
+    val consentStateValue =
+        if (consentState == Consent.CONSENTED || consentState == Consent.CONSENT_UNKNOWN) {
+            consentState.value
+        } else {
+            Consent.NO_CONSENT.value
+        }
+
+    return GetAsterismConsentResponse(
+        requestCode,
+        consentStateValue,
+        gmscoreIidToken,
+        fid,
+        consentVersion.value
+    )
+}

play-services-asterism/core/src/main/kotlin/com/google/android/gms/asterism/SetAsterismConsent.kt

@@ -0,0 +1,50 @@
+package com.google.android.gms.asterism
+
+import org.microg.gms.constellation.core.proto.AsterismClient
+import org.microg.gms.constellation.core.proto.AsterismConsent.DeviceConsentVersion
+import org.microg.gms.constellation.core.proto.Consent
+import org.microg.gms.constellation.core.proto.ConsentSource
+import org.microg.gms.constellation.core.proto.ConsentVersion
+
+enum class SetAsterismConsentRequestStatus(val value: Int) {
+    RESOURCE_TOS(0),
+    STATIC_STRING(1),
+    RCS(2),
+    ON_DEMAND(3),
+    RESOURCE_TOS_FALLBACK(4);
+
+    companion object {
+        fun fromValue(value: Int): SetAsterismConsentRequestStatus =
+            entries.find { it.value == value } ?: RESOURCE_TOS_FALLBACK
+    }
+}
+
+val SetAsterismConsentRequest.asterismClient: AsterismClient
+    get() = AsterismClient.fromValue(asterismClientValue) ?: AsterismClient.UNKNOWN_CLIENT
+
+val SetAsterismConsentRequest.consent: Consent
+    get() = Consent.fromValue(consentValue) ?: Consent.CONSENT_UNKNOWN
+
+val SetAsterismConsentRequest.consentVersion: ConsentVersion?
+    get() = ConsentVersion.fromValue(consentVersionValue)
+
+val SetAsterismConsentRequest.deviceConsentSource: ConsentSource
+    get() = ConsentSource.fromValue(deviceConsentSourceValue) ?: ConsentSource.SOURCE_UNSPECIFIED
+
+val SetAsterismConsentRequest.deviceConsentVersion: DeviceConsentVersion
+    get() = DeviceConsentVersion.fromValue(deviceConsentVersionValue).let {
+        if (it == null || it == DeviceConsentVersion.UNKNOWN) {
+            DeviceConsentVersion.PHONE_VERIFICATION_DEFAULT
+        } else {
+            it
+        }
+    }
+
+val SetAsterismConsentRequest.status: SetAsterismConsentRequestStatus
+    get() = SetAsterismConsentRequestStatus.fromValue(statusValue)
+
+fun SetAsterismConsentRequest.isDevicePnvrFlow(): Boolean {
+    return asterismClient == AsterismClient.CONSTELLATION &&
+            deviceConsentSourceValue > 0 &&
+            deviceConsentVersionValue > 0
+}

play-services-asterism/core/src/main/kotlin/org/microg/gms/asterism/core/AsterismApiService.kt

@@ -0,0 +1,88 @@
+package org.microg.gms.asterism.core
+
+import android.content.Context
+import android.os.Build
+import android.util.Log
+import com.google.android.gms.asterism.GetAsterismConsentRequest
+import com.google.android.gms.asterism.SetAsterismConsentRequest
+import com.google.android.gms.asterism.internal.IAsterismApiService
+import com.google.android.gms.asterism.internal.IAsterismCallbacks
+import com.google.android.gms.common.Feature
+import com.google.android.gms.common.internal.ConnectionInfo
+import com.google.android.gms.common.internal.GetServiceRequest
+import com.google.android.gms.common.internal.IGmsCallbacks
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.cancel
+import kotlinx.coroutines.launch
+import org.microg.gms.BaseService
+import org.microg.gms.common.GmsService
+import org.microg.gms.common.PackageUtils
+
+private const val TAG = "AsterismApiService"
+
+class AsterismApiService : BaseService(TAG, GmsService.ASTERISM) {
+    private val serviceScope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
+
+    override fun handleServiceRequest(
+        callback: IGmsCallbacks?,
+        request: GetServiceRequest?,
+        service: GmsService?
+    ) {
+        val packageName = PackageUtils.getAndCheckCallingPackage(this, request?.packageName)
+        if (!PackageUtils.isGooglePackage(this, packageName)) {
+            throw SecurityException("$packageName is not a Google package")
+        }
+        callback!!.onPostInitCompleteWithConnectionInfo(
+            0,
+            AsterismApiServiceImpl(this, serviceScope).asBinder(),
+            ConnectionInfo().apply {
+                features = arrayOf(
+                    Feature("asterism_consent", 3),
+                    Feature("one_time_verification", 1),
+                    Feature("carrier_auth", 1),
+                    Feature("verify_phone_number", 2),
+                    Feature("get_iid_token", 1),
+                    Feature("get_pnv_capabilities", 1),
+                    Feature("ts43", 1),
+                    Feature("verify_phone_number_local_read", 1)
+                )
+            }
+        )
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        serviceScope.cancel("AsterismApiService destroyed")
+    }
+}
+
+class AsterismApiServiceImpl(
+    private val context: Context,
+    private val serviceScope: CoroutineScope
+) : IAsterismApiService.Stub() {
+    override fun getAsterismConsent(
+        cb: IAsterismCallbacks?,
+        request: GetAsterismConsentRequest?,
+    ) {
+        Log.i(TAG, "getAsterismConsent(): $request")
+        if (cb == null || request == null) return
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return
+        serviceScope.launch { handleGetAsterismConsent(context, cb, request) }
+    }
+
+    override fun setAsterismConsent(cb: IAsterismCallbacks?, request: SetAsterismConsentRequest?) {
+        Log.i(TAG, "setAsterismConsent(): $request")
+        if (cb == null || request == null) return
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return
+        serviceScope.launch { handleSetAsterismConsent(context, cb, request) }
+    }
+
+    override fun getIsPnvrConstellationDevice(cb: IAsterismCallbacks?) {
+        Log.i(TAG, "getIsPnvrConstellationDevice()")
+        if (cb == null) return
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return
+        serviceScope.launch { handleGetIsPnvrConstellationDevice(context, cb) }
+    }
+}