Add WearOS companion app #3185

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

TheLastProject merged 50 commits into CatimaLoyalty:wip/wearos from blacklight:feat/wearos

Jul 19, 2026

.github/workflows/wear.yml

-Original file line number
+Diff line change
@@ -0,0 +1,46 @@
+    name: Android Wear CI
+    on:
+      workflow_dispatch:
+      push:
+        branches:
+          - main
+          - staging
+          - trying
+      pull_request:
+        branches:
+          - main
+    permissions:
+      actions: none
+      checks: none
+      contents: read
+      deployments: none
+      discussions: none
+      id-token: none
+      issues: none
+      packages: none
+      pages: none
+      pull-requests: none
+      repository-projects: none
+      security-events: none
+      statuses: none
+    env:
+      JAVA_HOME: /usr/lib/jvm/java-25-openjdk-amd64
+    jobs:
+      build:
+        runs-on: ubuntu-latest
+        steps:
+          - uses: actions/checkout@v7.0.0
+          - uses: gradle/actions/wrapper-validation@v6.2.0
+          - name: set up OpenJDK 25
+            run: |
+              sudo apt-get update
+              sudo apt-get install -y openjdk-25-jdk-headless
+              sudo update-alternatives --auto java
+          - name: Build
+            run: ./gradlew :wear:assembleRelease
+          - name: Check for non-free libraries
+            run: |
+              wget -q https://codeberg.org/Katastima/apkscanner/releases/download/v0.0.7/apk-scanner_v0.0.7.jar
+              java -jar apk-scanner_v0.0.7.jar scan-apk 'wear/build/outputs/apk/release/wear-release-unsigned.apk'
+          - name: Check lint
+            run: ./gradlew :wear:lintRelease

.gitignore

-Original file line number
+Diff line change
@@ Expand Up / @@ -19,6 +19,8 @@ @@
     /app/*.log
     /app/build
     /app/release
+    /wear/build
+    /wear/release
     /.idea/*
     !/.idea/icon.svg
     # Bundle
@@ Expand All / @@ -28,3 +30,4 @@ @@
     # Catima-specific
     SHA256SUMS
+    /shared/build

app/build.gradle.kts

-Original file line number
+Diff line change
@@ Expand Up / @@ -113,6 +113,8 @@ android { @@
     }
     dependencies {
+        implementation(project(":shared"))
         // AndroidX
         implementation(libs.androidx.appcompat.appcompat)
         implementation(libs.androidx.constraintlayout.constraintlayout)
@@ Expand Down @@

app/src/main/AndroidManifest.xml

-Original file line number
+Diff line change
@@ Expand Up / @@ -13,6 +13,11 @@ @@
         <uses-permission android:name="android.permission.CAMERA" />
         <uses-permission android:name="android.permission.NFC" />
+        <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
+        <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
+        <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+        <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+        <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CONNECTED_DEVICE" />
         <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="23" />
         <uses-feature
@@ Expand Down Expand Up / @@ -226,5 +231,10 @@ @@
                     <action android:name="android.service.controls.ControlsProviderService" />
                 </intent-filter>
             </service>
+            <service
+                android:name=".wearos.BluetoothServerService"
+                android:exported="false"
+                android:foregroundServiceType="connectedDevice" />
         </application>
     </manifest>

app/src/main/java/protect/card_locker/LoyaltyCardLockerApplication.java

-Original file line number
+Diff line change
@@ -1,16 +1,17 @@
     package protect.card_locker;
     import android.app.Application;
+    import android.content.Intent;
     import androidx.appcompat.app.AppCompatDelegate;
     import org.acra.ACRA;
     import org.acra.config.CoreConfigurationBuilder;
     import org.acra.config.DialogConfigurationBuilder;
     import org.acra.config.MailSenderConfigurationBuilder;
     import org.acra.data.StringFormat;
     import protect.card_locker.preferences.Settings;
+    import protect.card_locker.wearos.WearSyncServiceManager;
     public class LoyaltyCardLockerApplication extends Application {
@@ Expand Down Expand Up / @@ -41,5 +42,10 @@ public void onCreate() { @@
             // Set theme
             Settings settings = new Settings(this);
             AppCompatDelegate.setDefaultNightMode(settings.getTheme());
+            // Start Bluetooth server for Wear OS companion if enabled.
+            // The service checks BLUETOOTH_CONNECT itself and stops if the permission is missing.
+            // The permission is requested from the launcher Activity when the UI resumes.
+            WearSyncServiceManager.INSTANCE.synchronize(this, null);
         }
     }

app/src/main/java/protect/card_locker/MainActivity.kt

-Original file line number
+Diff line change
@@ Expand Up / @@ -37,6 +37,7 @@ import protect.card_locker.databinding.MainActivityBinding @@
     import protect.card_locker.databinding.SortingOptionBinding
     import protect.card_locker.preferences.Settings
     import protect.card_locker.preferences.SettingsActivity
+    import protect.card_locker.wearos.WearSyncPermissionRequester
     import java.io.UnsupportedEncodingException
     import java.util.concurrent.atomic.AtomicInteger
     import androidx.core.content.edit
@@ Expand All @@
         private lateinit var mUpdateLoyaltyCardListRunnable: Runnable
         private lateinit var mBarcodeScannerLauncher: ActivityResultLauncher<Intent>
         private lateinit var mSettingsLauncher: ActivityResultLauncher<Intent>
+        private lateinit var mWearSyncPermissionRequester: WearSyncPermissionRequester
         private val mCurrentActionModeCallback: ActionMode.Callback = object : ActionMode.Callback {
             override fun onCreateActionMode(inputMode: ActionMode, inputMenu: Menu?): Boolean {
@@ Expand Down Expand Up @@
                 }
             }
+            mWearSyncPermissionRequester = WearSyncPermissionRequester(this, this)
             onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
                 override fun handleOnBackPressed() {
                     if (mSearchView != null && !mSearchView!!.isIconified) {
@@ Expand Down Expand Up @@
                 val settings = Settings(this)
                 layoutManager.setSpanCount(settings.getPreferredColumnCount())
             }
+            mWearSyncPermissionRequester.synchronize()
         }
         private fun displayCardSetupOptions(menu: Menu, shouldShow: Boolean) {
@@ Expand Down Expand Up @@
             ShortcutHelper.updateShortcuts(mAdapter.mContext)
         }
-        private fun processParseResultList(
-            parseResultList: MutableList<ParseResult?>,
-            group: String?,
-            closeAppOnNoBarcode: Boolean
-        ) {
+        private fun processParseResultList(parseResultList: MutableList<ParseResult?>) {
             require(!parseResultList.isEmpty()) { "parseResultList may not be empty" }
             Utils.makeUserChooseParseResultFromList(
@@ Expand All @@
                         val intent =
                             Intent(applicationContext, LoyaltyCardEditActivity::class.java)
                         val bundle = parseResult.toLoyaltyCardBundle(this@MainActivity)
-                        if (group != null) {
-                            bundle.putString(LoyaltyCardEditActivity.BUNDLE_ADDGROUP, group)
-                        }
                         intent.putExtras(bundle)
                         startActivity(intent)
                     }
                     override fun onUserDismissedSelector() {
-                        if (closeAppOnNoBarcode) {
-                            finish()
-                        }
+                        finish()
                     }
                 })
         }
@@ Expand Down Expand Up @@
                 return
             }
-            processParseResultList(parseResultList, null, true)
+            processParseResultList(parseResultList)
         }
         private fun extractIntentFields(intent: Intent) {
@@ Expand Down @@

app/src/main/java/protect/card_locker/NotificationInfo.kt

-Original file line number
+Diff line change
@@ -0,0 +1,8 @@
+    package protect.card_locker
+    object NotificationInfo {
+        object WearBluetooth {
+            const val NOTIFICATION_ID = 1001
+            const val CHANNEL_ID = "catima_wear_bt"
+        }
+    }

app/src/main/java/protect/card_locker/preferences/Settings.java

-Original file line number
+Diff line change
@@ Expand Up / @@ -112,4 +112,8 @@ public int getPreferredColumnCount() { @@
         public boolean useVolumeKeysForNavigation() {
             return getBoolean(R.string.settings_key_use_volume_keys_navigation, false);
         }
+        public boolean getWearSyncEnabled() {
+            return getBoolean(R.string.settings_key_wear_sync, false);
+        }
     }

app/src/main/java/protect/card_locker/preferences/SettingsActivity.kt

-Original file line number
+Diff line change
@@ -1,22 +1,26 @@
     package protect.card_locker.preferences
-    import android.app.Activity
     import android.content.Intent
+    import android.net.Uri
     import android.os.Build
     import android.os.Bundle
+    import android.provider.Settings
     import android.view.MenuItem
     import androidx.activity.OnBackPressedCallback
     import androidx.appcompat.app.AppCompatDelegate
     import androidx.core.os.LocaleListCompat
     import androidx.preference.ListPreference
     import androidx.preference.Preference
     import androidx.preference.PreferenceFragmentCompat
+    import androidx.preference.SwitchPreferenceCompat
+    import com.google.android.material.snackbar.Snackbar
     import protect.card_locker.BuildConfig
     import protect.card_locker.CatimaAppCompatActivity
     import protect.card_locker.MainActivity
     import protect.card_locker.R
     import protect.card_locker.Utils
     import protect.card_locker.databinding.SettingsActivityBinding
+    import protect.card_locker.wearos.WearSyncPermissionRequester
     class SettingsActivity : CatimaAppCompatActivity() {
@@ Expand Down Expand Up / @@ -81,7 +85,16 @@ class SettingsActivity : CatimaAppCompatActivity() { @@
         class SettingsFragment : PreferenceFragmentCompat() {
             var mReloadMain: Boolean = false
+            private lateinit var wearSyncPermissionRequester: WearSyncPermissionRequester
+            override fun onResume() {
+                super.onResume()
+                wearSyncPermissionRequester.synchronize()
+            }
             override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
+                wearSyncPermissionRequester = WearSyncPermissionRequester(this, requireContext())
                 // Load the preferences from an XML resource
                 addPreferencesFromResource(R.xml.preferences)
@@ Expand All / @@ -104,7 +117,7 @@ class SettingsActivity : CatimaAppCompatActivity() { @@
                 val oledDarkPreference = findPreference<Preference>(getString(R.string.settings_key_oled_dark))
                 oledDarkPreference!!.setOnPreferenceChangeListener { _, _ ->
-                    refreshActivity(true)
+                    refreshActivity()
                     true
                 }
@@ Expand Down Expand Up / @@ -148,7 +161,7 @@ class SettingsActivity : CatimaAppCompatActivity() { @@
                 localePreference.setOnPreferenceChangeListener { _, newValue ->
                     // See corresponding comment in Utils.updateBaseContextLocale for Android 6- notes
                     if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
-                        refreshActivity(true)
+                        refreshActivity()
                         return@setOnPreferenceChangeListener true
                     }
                     val newLocale = newValue as String
@@ Expand All / @@ -157,13 +170,46 @@ class SettingsActivity : CatimaAppCompatActivity() { @@
                     true
                 }
+                val wearSyncPreference = findPreference<SwitchPreferenceCompat>(getString(R.string.settings_key_wear_sync))
+                wearSyncPreference!!.setOnPreferenceChangeListener { preference, newValue ->
+                    val enabled = newValue as Boolean
+                    if (enabled) {
+                        wearSyncPermissionRequester.onWearSyncChanged(true) { granted ->
+                            if (granted) {
+                                (preference as? SwitchPreferenceCompat)?.isChecked = true
+                            } else {
+                                showWearSyncPermissionDeniedSnackbar()
+                            }
+                        }
+                        false
+                    } else {
+                        wearSyncPermissionRequester.onWearSyncChanged(false)
+                        true
+                    }
+                }
                 // Hide crash reporter settings on builds it's not enabled on
                 val crashReporterPreference = findPreference<Preference>("acra.enable")
                 crashReporterPreference!!.isVisible = BuildConfig.useAcraCrashReporter
             }
-            private fun refreshActivity(reloadMain: Boolean) {
-                mReloadMain = reloadMain || mReloadMain
+            private fun showWearSyncPermissionDeniedSnackbar() {
+                Snackbar.make(
+                    requireView(),
+                    R.string.wear_sync_permission_required,
+                    Snackbar.LENGTH_LONG
+                ).setAction(R.string.open_settings) {
+                    startActivity(
+                        Intent(
+                            Settings.ACTION_APPLICATION_DETAILS_SETTINGS,
+                            Uri.fromParts("package", requireContext().packageName, null)
+                        )
+                    )
+                }.show()
+            }
+            private fun refreshActivity() {
+                mReloadMain = true
                 activity?.recreate()
             }
         }
@@ Expand Down @@

Navigation Menu

Uh oh!

Uh oh!

Add WearOS companion app #3185

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Uh oh!

Uh oh!