@onekeyfe/react-native-device-utils 3.0.18 → 3.0.20

package/android/build.gradle

@@ -39,6 +39,8 @@ android {
     minSdkVersion getExtOrIntegerDefault("minSdkVersion")
     targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
 
+    consumerProguardFiles 'consumer-rules.pro'
+
     externalNativeBuild {
       cmake {
         cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"

package/android/consumer-rules.pro

@@ -0,0 +1,10 @@
+# Keep host app's BuildConfig class name AND its ANDROID_CHANNEL field so
+# getAndroidChannel() can read it via `Class.forName(...).getField("ANDROID_CHANNEL")`
+# when R8/Proguard is enabled in the consumer app.
+#
+# `-keep class` (not `-keepclassmembers`) is required because the class is
+# only referenced as a string literal in reflection, so R8 cannot detect the
+# usage and would otherwise rename/strip the class entirely.
+-keep class **.BuildConfig {
+    public static final java.lang.String ANDROID_CHANNEL;
+}

package/android/src/main/java/com/margelo/nitro/reactnativedeviceutils/ReactNativeDeviceUtils.kt

@@ -1027,4 +1027,106 @@ class ReactNativeDeviceUtils : HybridReactNativeDeviceUtilsSpec(), LifecycleEven
         }
         return Promise.resolved(action)
     }
+
+    // MARK: - Android Channel & Installer
+
+    override fun getAndroidChannel(): AndroidChannel {
+        return try {
+            val context = NitroModules.applicationContext
+                ?: return AndroidChannel.DIRECT  // Match gradle default when context unavailable
+            val raw = readAndroidChannelFromBuildConfig(context)
+            when (raw) {
+                "direct" -> AndroidChannel.DIRECT
+                "google" -> AndroidChannel.GOOGLE
+                "huawei" -> AndroidChannel.HUAWEI
+                null -> {
+                    // Reflection found no BuildConfig.ANDROID_CHANNEL — match gradle default.
+                    OneKeyLog.warn("DeviceUtils", "getAndroidChannel: BuildConfig.ANDROID_CHANNEL not found, defaulting to direct")
+                    AndroidChannel.DIRECT
+                }
+                else -> {
+                    // Read a string we don't know how to map — host has a custom channel value.
+                    OneKeyLog.warn("DeviceUtils", "getAndroidChannel unrecognized value: $raw")
+                    AndroidChannel.UNKNOWN
+                }
+            }
+        } catch (e: Exception) {
+            OneKeyLog.warn("DeviceUtils", "getAndroidChannel failed: ${e.message}")
+            AndroidChannel.DIRECT  // Match gradle default on unexpected errors
+        }
+    }
+
+    /**
+     * Reflect the host app's BuildConfig.ANDROID_CHANNEL. BuildConfig is generated at the
+     * module `namespace` package, which is not always the runtime `applicationId`
+     * (AGP's applicationIdSuffix appends to packageName; custom Application classes may live
+     * in a sub-package of the namespace). Strategy:
+     *   1. Try `context.packageName` as-is (matches the common case where namespace == applicationId).
+     *   2. Progressively strip trailing package segments from packageName (covers any
+     *      applicationIdSuffix, including custom ones beyond `.debug`/`.beta`).
+     *   3. Try the Application class's declared package, then walk up its parents (covers
+     *      cases where the Application class is in a sub-package of the namespace).
+     * We pick the first candidate whose BuildConfig exposes an ANDROID_CHANNEL field.
+     */
+    private fun readAndroidChannelFromBuildConfig(context: Context): String? {
+        val candidates = LinkedHashSet<String>()
+        addPackageAndParents(candidates, context.packageName, maxParents = 2)
+        context.applicationContext.javaClass.`package`?.name?.let { parentPkg ->
+            addPackageAndParents(candidates, parentPkg, maxParents = 3)
+        }
+
+        for (candidate in candidates) {
+            try {
+                val cls = Class.forName("$candidate.BuildConfig")
+                val field = cls.getField("ANDROID_CHANNEL")
+                return field.get(null) as? String
+            } catch (_: ClassNotFoundException) {
+                // Candidate has no BuildConfig at this package — try next
+            } catch (_: NoSuchFieldException) {
+                // BuildConfig exists but has no ANDROID_CHANNEL — try next
+            }
+        }
+        return null
+    }
+
+    /** Add the given package name and up to [maxParents] parent packages (strip trailing segments). */
+    private fun addPackageAndParents(
+        out: LinkedHashSet<String>,
+        packageName: String,
+        maxParents: Int,
+    ) {
+        out.add(packageName)
+        var current = packageName
+        for (i in 0 until maxParents) {
+            val lastDot = current.lastIndexOf('.')
+            if (lastDot <= 0) break
+            current = current.substring(0, lastDot)
+            out.add(current)
+        }
+    }
+
+    override fun getInstallerPackageName(): InstallerPackageName {
+        return try {
+            val context = NitroModules.applicationContext ?: return InstallerPackageName.UNKNOWN
+            val packageName = context.packageName
+            val pm = context.packageManager
+            val installer: String? = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+                pm.getInstallSourceInfo(packageName).installingPackageName
+            } else {
+                @Suppress("DEPRECATION")
+                pm.getInstallerPackageName(packageName)
+            }
+            when (installer) {
+                "com.android.vending" -> InstallerPackageName.PLAYSTORE
+                "com.huawei.appmarket" -> InstallerPackageName.HUAWEIAPPGALLERY
+                null, "" -> InstallerPackageName.UNKNOWN
+                else -> InstallerPackageName.OTHER
+            }
+        } catch (e: PackageManager.NameNotFoundException) {
+            InstallerPackageName.UNKNOWN
+        } catch (e: Exception) {
+            OneKeyLog.warn("DeviceUtils", "getInstallerPackageName failed: ${e.message}")
+            InstallerPackageName.UNKNOWN
+        }
+    }
 }

package/ios/ReactNativeDeviceUtils.swift

@@ -236,4 +236,28 @@ class ReactNativeDeviceUtils: HybridReactNativeDeviceUtilsSpec {
         }
         return Promise.resolved(withResult: action)
     }
+
+    // MARK: - Android Channel & Installer
+
+    func getAndroidChannel() throws -> AndroidChannel {
+        // iOS has no ANDROID_CHANNEL concept; signal with `.unknown` for API parity.
+        return .unknown
+    }
+
+    func getInstallerPackageName() throws -> InstallerPackageName {
+        // Mirror react-native-device-info: distinguish AppStore / TestFlight / Other
+        // via receipt path and embedded mobileprovision. Simulator has neither.
+        #if targetEnvironment(simulator)
+        return .unknown
+        #else
+        let hasEmbeddedProvision = Bundle.main.path(forResource: "embedded", ofType: "mobileprovision") != nil
+        if let receiptUrl = Bundle.main.appStoreReceiptURL {
+            if receiptUrl.lastPathComponent == "sandboxReceipt" {
+                return hasEmbeddedProvision ? .other : .testflight
+            }
+            return hasEmbeddedProvision ? .other : .appstore
+        }
+        return hasEmbeddedProvision ? .other : .unknown
+        #endif
+    }
 }

package/lib/typescript/src/ReactNativeDeviceUtils.nitro.d.ts

@@ -1,5 +1,7 @@
 import type { HybridObject } from 'react-native-nitro-modules';
 export type UserInterfaceStyle = 'light' | 'dark' | 'unspecified';
+export type AndroidChannel = 'direct' | 'google' | 'huawei' | 'unknown';
+export type InstallerPackageName = 'appStore' | 'testFlight' | 'other' | 'playStore' | 'huaweiAppGallery' | 'unknown';
 export interface DualScreenInfoRect {
     x: number;
     y: number;
@@ -46,5 +48,7 @@ export interface ReactNativeDeviceUtils extends HybridObject<{
     incrementConsecutiveBootFailCount(): void;
     setConsecutiveBootFailCount(count: number): void;
     getAndClearRecoveryAction(): Promise<string>;
+    getAndroidChannel(): AndroidChannel;
+    getInstallerPackageName(): InstallerPackageName;
 }
 //# sourceMappingURL=ReactNativeDeviceUtils.nitro.d.ts.map

package/nitrogen/generated/android/c++/JAndroidChannel.hpp

@@ -0,0 +1,65 @@
+///
+/// JAndroidChannel.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "AndroidChannel.hpp"
+
+namespace margelo::nitro::reactnativedeviceutils {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ enum "AndroidChannel" and the the Kotlin enum "AndroidChannel".
+   */
+  struct JAndroidChannel final: public jni::JavaClass<JAndroidChannel> {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/reactnativedeviceutils/AndroidChannel;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based enum to the C++ enum AndroidChannel.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    AndroidChannel toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldOrdinal = clazz->getField<int>("value");
+      int ordinal = this->getFieldValue(fieldOrdinal);
+      return static_cast<AndroidChannel>(ordinal);
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based enum with the given C++ enum's value.
+     */
+    [[maybe_unused]]
+    static jni::alias_ref<JAndroidChannel> fromCpp(AndroidChannel value) {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldDIRECT = clazz->getStaticField<JAndroidChannel>("DIRECT");
+      static const auto fieldGOOGLE = clazz->getStaticField<JAndroidChannel>("GOOGLE");
+      static const auto fieldHUAWEI = clazz->getStaticField<JAndroidChannel>("HUAWEI");
+      static const auto fieldUNKNOWN = clazz->getStaticField<JAndroidChannel>("UNKNOWN");
+      
+      switch (value) {
+        case AndroidChannel::DIRECT:
+          return clazz->getStaticFieldValue(fieldDIRECT);
+        case AndroidChannel::GOOGLE:
+          return clazz->getStaticFieldValue(fieldGOOGLE);
+        case AndroidChannel::HUAWEI:
+          return clazz->getStaticFieldValue(fieldHUAWEI);
+        case AndroidChannel::UNKNOWN:
+          return clazz->getStaticFieldValue(fieldUNKNOWN);
+        default:
+          std::string stringValue = std::to_string(static_cast<int>(value));
+          throw std::invalid_argument("Invalid enum value (" + stringValue + "!");
+      }
+    }
+  };
+
+} // namespace margelo::nitro::reactnativedeviceutils

package/nitrogen/generated/android/c++/JHybridReactNativeDeviceUtilsSpec.cpp

@@ -15,6 +15,10 @@ namespace margelo::nitro::reactnativedeviceutils { struct LaunchOptions; }
 namespace margelo::nitro::reactnativedeviceutils { struct WebViewPackageInfo; }
 // Forward declaration of `GooglePlayServicesStatus` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct GooglePlayServicesStatus; }
+// Forward declaration of `AndroidChannel` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class AndroidChannel; }
+// Forward declaration of `InstallerPackageName` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class InstallerPackageName; }
 // Forward declaration of `UserInterfaceStyle` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { enum class UserInterfaceStyle; }
 
@@ -31,6 +35,10 @@ namespace margelo::nitro::reactnativedeviceutils { enum class UserInterfaceStyle
 #include "JWebViewPackageInfo.hpp"
 #include "GooglePlayServicesStatus.hpp"
 #include "JGooglePlayServicesStatus.hpp"
+#include "AndroidChannel.hpp"
+#include "JAndroidChannel.hpp"
+#include "InstallerPackageName.hpp"
+#include "JInstallerPackageName.hpp"
 #include <functional>
 #include "JFunc_void_bool.hpp"
 #include <NitroModules/JNICallable.hpp>
@@ -316,5 +324,15 @@ namespace margelo::nitro::reactnativedeviceutils {
       return __promise;
     }();
   }
+  AndroidChannel JHybridReactNativeDeviceUtilsSpec::getAndroidChannel() {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JAndroidChannel>()>("getAndroidChannel");
+    auto __result = method(_javaPart);
+    return __result->toCpp();
+  }
+  InstallerPackageName JHybridReactNativeDeviceUtilsSpec::getInstallerPackageName() {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JInstallerPackageName>()>("getInstallerPackageName");
+    auto __result = method(_javaPart);
+    return __result->toCpp();
+  }
 
 } // namespace margelo::nitro::reactnativedeviceutils

package/nitrogen/generated/android/c++/JHybridReactNativeDeviceUtilsSpec.hpp

@@ -77,6 +77,8 @@ namespace margelo::nitro::reactnativedeviceutils {
     void incrementConsecutiveBootFailCount() override;
     void setConsecutiveBootFailCount(double count) override;
     std::shared_ptr<Promise<std::string>> getAndClearRecoveryAction() override;
+    AndroidChannel getAndroidChannel() override;
+    InstallerPackageName getInstallerPackageName() override;
 
   private:
     friend HybridBase;

package/nitrogen/generated/android/c++/JInstallerPackageName.hpp

@@ -0,0 +1,71 @@
+///
+/// JInstallerPackageName.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "InstallerPackageName.hpp"
+
+namespace margelo::nitro::reactnativedeviceutils {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ enum "InstallerPackageName" and the the Kotlin enum "InstallerPackageName".
+   */
+  struct JInstallerPackageName final: public jni::JavaClass<JInstallerPackageName> {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/reactnativedeviceutils/InstallerPackageName;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based enum to the C++ enum InstallerPackageName.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    InstallerPackageName toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldOrdinal = clazz->getField<int>("value");
+      int ordinal = this->getFieldValue(fieldOrdinal);
+      return static_cast<InstallerPackageName>(ordinal);
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based enum with the given C++ enum's value.
+     */
+    [[maybe_unused]]
+    static jni::alias_ref<JInstallerPackageName> fromCpp(InstallerPackageName value) {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldUNKNOWN = clazz->getStaticField<JInstallerPackageName>("UNKNOWN");
+      static const auto fieldAPPSTORE = clazz->getStaticField<JInstallerPackageName>("APPSTORE");
+      static const auto fieldTESTFLIGHT = clazz->getStaticField<JInstallerPackageName>("TESTFLIGHT");
+      static const auto fieldOTHER = clazz->getStaticField<JInstallerPackageName>("OTHER");
+      static const auto fieldPLAYSTORE = clazz->getStaticField<JInstallerPackageName>("PLAYSTORE");
+      static const auto fieldHUAWEIAPPGALLERY = clazz->getStaticField<JInstallerPackageName>("HUAWEIAPPGALLERY");
+      
+      switch (value) {
+        case InstallerPackageName::UNKNOWN:
+          return clazz->getStaticFieldValue(fieldUNKNOWN);
+        case InstallerPackageName::APPSTORE:
+          return clazz->getStaticFieldValue(fieldAPPSTORE);
+        case InstallerPackageName::TESTFLIGHT:
+          return clazz->getStaticFieldValue(fieldTESTFLIGHT);
+        case InstallerPackageName::OTHER:
+          return clazz->getStaticFieldValue(fieldOTHER);
+        case InstallerPackageName::PLAYSTORE:
+          return clazz->getStaticFieldValue(fieldPLAYSTORE);
+        case InstallerPackageName::HUAWEIAPPGALLERY:
+          return clazz->getStaticFieldValue(fieldHUAWEIAPPGALLERY);
+        default:
+          std::string stringValue = std::to_string(static_cast<int>(value));
+          throw std::invalid_argument("Invalid enum value (" + stringValue + "!");
+      }
+    }
+  };
+
+} // namespace margelo::nitro::reactnativedeviceutils

package/nitrogen/generated/android/kotlin/com/margelo/nitro/reactnativedeviceutils/AndroidChannel.kt

@@ -0,0 +1,23 @@
+///
+/// AndroidChannel.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.reactnativedeviceutils
+
+import androidx.annotation.Keep
+import com.facebook.proguard.annotations.DoNotStrip
+
+/**
+ * Represents the JavaScript enum/union "AndroidChannel".
+ */
+@DoNotStrip
+@Keep
+enum class AndroidChannel(@DoNotStrip @Keep val value: Int) {
+  DIRECT(0),
+  GOOGLE(1),
+  HUAWEI(2),
+  UNKNOWN(3);
+}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/reactnativedeviceutils/HybridReactNativeDeviceUtilsSpec.kt

@@ -142,6 +142,14 @@ abstract class HybridReactNativeDeviceUtilsSpec: HybridObject() {
   @DoNotStrip
   @Keep
   abstract fun getAndClearRecoveryAction(): Promise<String>
+  
+  @DoNotStrip
+  @Keep
+  abstract fun getAndroidChannel(): AndroidChannel
+  
+  @DoNotStrip
+  @Keep
+  abstract fun getInstallerPackageName(): InstallerPackageName
 
   private external fun initHybrid(): HybridData
 

package/nitrogen/generated/android/kotlin/com/margelo/nitro/reactnativedeviceutils/InstallerPackageName.kt

@@ -0,0 +1,25 @@
+///
+/// InstallerPackageName.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.reactnativedeviceutils
+
+import androidx.annotation.Keep
+import com.facebook.proguard.annotations.DoNotStrip
+
+/**
+ * Represents the JavaScript enum/union "InstallerPackageName".
+ */
+@DoNotStrip
+@Keep
+enum class InstallerPackageName(@DoNotStrip @Keep val value: Int) {
+  UNKNOWN(0),
+  APPSTORE(1),
+  TESTFLIGHT(2),
+  OTHER(3),
+  PLAYSTORE(4),
+  HUAWEIAPPGALLERY(5);
+}

package/nitrogen/generated/ios/ReactNativeDeviceUtils-Swift-Cxx-Bridge.hpp

@@ -8,12 +8,16 @@
 #pragma once
 
 // Forward declarations of C++ defined types
+// Forward declaration of `AndroidChannel` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class AndroidChannel; }
 // Forward declaration of `DualScreenInfoRect` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct DualScreenInfoRect; }
 // Forward declaration of `GooglePlayServicesStatus` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct GooglePlayServicesStatus; }
 // Forward declaration of `HybridReactNativeDeviceUtilsSpec` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { class HybridReactNativeDeviceUtilsSpec; }
+// Forward declaration of `InstallerPackageName` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class InstallerPackageName; }
 // Forward declaration of `LaunchOptions` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct LaunchOptions; }
 // Forward declaration of `WebViewPackageInfo` to properly resolve imports.
@@ -24,9 +28,11 @@ namespace margelo::nitro::reactnativedeviceutils { struct WebViewPackageInfo; }
 namespace ReactNativeDeviceUtils { class HybridReactNativeDeviceUtilsSpec_cxx; }
 
 // Include C++ defined types
+#include "AndroidChannel.hpp"
 #include "DualScreenInfoRect.hpp"
 #include "GooglePlayServicesStatus.hpp"
 #include "HybridReactNativeDeviceUtilsSpec.hpp"
+#include "InstallerPackageName.hpp"
 #include "LaunchOptions.hpp"
 #include "WebViewPackageInfo.hpp"
 #include <NitroModules/Promise.hpp>
@@ -518,5 +524,23 @@ namespace margelo::nitro::reactnativedeviceutils::bridge::swift {
   inline Result_std__shared_ptr_Promise_GooglePlayServicesStatus___ create_Result_std__shared_ptr_Promise_GooglePlayServicesStatus___(const std::exception_ptr& error) noexcept {
     return Result<std::shared_ptr<Promise<GooglePlayServicesStatus>>>::withError(error);
   }
+  
+  // pragma MARK: Result<AndroidChannel>
+  using Result_AndroidChannel_ = Result<AndroidChannel>;
+  inline Result_AndroidChannel_ create_Result_AndroidChannel_(AndroidChannel value) noexcept {
+    return Result<AndroidChannel>::withValue(std::move(value));
+  }
+  inline Result_AndroidChannel_ create_Result_AndroidChannel_(const std::exception_ptr& error) noexcept {
+    return Result<AndroidChannel>::withError(error);
+  }
+  
+  // pragma MARK: Result<InstallerPackageName>
+  using Result_InstallerPackageName_ = Result<InstallerPackageName>;
+  inline Result_InstallerPackageName_ create_Result_InstallerPackageName_(InstallerPackageName value) noexcept {
+    return Result<InstallerPackageName>::withValue(std::move(value));
+  }
+  inline Result_InstallerPackageName_ create_Result_InstallerPackageName_(const std::exception_ptr& error) noexcept {
+    return Result<InstallerPackageName>::withError(error);
+  }
 
 } // namespace margelo::nitro::reactnativedeviceutils::bridge::swift

package/nitrogen/generated/ios/ReactNativeDeviceUtils-Swift-Cxx-Umbrella.hpp

@@ -8,12 +8,16 @@
 #pragma once
 
 // Forward declarations of C++ defined types
+// Forward declaration of `AndroidChannel` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class AndroidChannel; }
 // Forward declaration of `DualScreenInfoRect` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct DualScreenInfoRect; }
 // Forward declaration of `GooglePlayServicesStatus` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct GooglePlayServicesStatus; }
 // Forward declaration of `HybridReactNativeDeviceUtilsSpec` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { class HybridReactNativeDeviceUtilsSpec; }
+// Forward declaration of `InstallerPackageName` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class InstallerPackageName; }
 // Forward declaration of `LaunchOptions` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct LaunchOptions; }
 // Forward declaration of `UserInterfaceStyle` to properly resolve imports.
@@ -22,9 +26,11 @@ namespace margelo::nitro::reactnativedeviceutils { enum class UserInterfaceStyle
 namespace margelo::nitro::reactnativedeviceutils { struct WebViewPackageInfo; }
 
 // Include C++ defined types
+#include "AndroidChannel.hpp"
 #include "DualScreenInfoRect.hpp"
 #include "GooglePlayServicesStatus.hpp"
 #include "HybridReactNativeDeviceUtilsSpec.hpp"
+#include "InstallerPackageName.hpp"
 #include "LaunchOptions.hpp"
 #include "UserInterfaceStyle.hpp"
 #include "WebViewPackageInfo.hpp"

package/nitrogen/generated/ios/c++/HybridReactNativeDeviceUtilsSpecSwift.hpp

@@ -22,6 +22,10 @@ namespace margelo::nitro::reactnativedeviceutils { struct LaunchOptions; }
 namespace margelo::nitro::reactnativedeviceutils { struct WebViewPackageInfo; }
 // Forward declaration of `GooglePlayServicesStatus` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct GooglePlayServicesStatus; }
+// Forward declaration of `AndroidChannel` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class AndroidChannel; }
+// Forward declaration of `InstallerPackageName` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class InstallerPackageName; }
 
 #include "DualScreenInfoRect.hpp"
 #include <vector>
@@ -33,6 +37,8 @@ namespace margelo::nitro::reactnativedeviceutils { struct GooglePlayServicesStat
 #include <optional>
 #include "WebViewPackageInfo.hpp"
 #include "GooglePlayServicesStatus.hpp"
+#include "AndroidChannel.hpp"
+#include "InstallerPackageName.hpp"
 
 #include "ReactNativeDeviceUtils-Swift-Cxx-Umbrella.hpp"
 
@@ -246,6 +252,22 @@ namespace margelo::nitro::reactnativedeviceutils {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline AndroidChannel getAndroidChannel() override {
+      auto __result = _swiftPart.getAndroidChannel();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
+    inline InstallerPackageName getInstallerPackageName() override {
+      auto __result = _swiftPart.getInstallerPackageName();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
 
   private:
     ReactNativeDeviceUtils::HybridReactNativeDeviceUtilsSpec_cxx _swiftPart;

package/nitrogen/generated/ios/swift/AndroidChannel.swift

@@ -0,0 +1,48 @@
+///
+/// AndroidChannel.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+/**
+ * Represents the JS union `AndroidChannel`, backed by a C++ enum.
+ */
+public typealias AndroidChannel = margelo.nitro.reactnativedeviceutils.AndroidChannel
+
+public extension AndroidChannel {
+  /**
+   * Get a AndroidChannel for the given String value, or
+   * return `nil` if the given value was invalid/unknown.
+   */
+  init?(fromString string: String) {
+    switch string {
+      case "direct":
+        self = .direct
+      case "google":
+        self = .google
+      case "huawei":
+        self = .huawei
+      case "unknown":
+        self = .unknown
+      default:
+        return nil
+    }
+  }
+
+  /**
+   * Get the String value this AndroidChannel represents.
+   */
+  var stringValue: String {
+    switch self {
+      case .direct:
+        return "direct"
+      case .google:
+        return "google"
+      case .huawei:
+        return "huawei"
+      case .unknown:
+        return "unknown"
+    }
+  }
+}

package/nitrogen/generated/ios/swift/HybridReactNativeDeviceUtilsSpec.swift

@@ -37,6 +37,8 @@ public protocol HybridReactNativeDeviceUtilsSpec_protocol: HybridObject {
   func incrementConsecutiveBootFailCount() throws -> Void
   func setConsecutiveBootFailCount(count: Double) throws -> Void
   func getAndClearRecoveryAction() throws -> Promise<String>
+  func getAndroidChannel() throws -> AndroidChannel
+  func getInstallerPackageName() throws -> InstallerPackageName
 }
 
 public extension HybridReactNativeDeviceUtilsSpec_protocol {

package/nitrogen/generated/ios/swift/HybridReactNativeDeviceUtilsSpec_cxx.swift

@@ -479,4 +479,28 @@ open class HybridReactNativeDeviceUtilsSpec_cxx {
       return bridge.create_Result_std__shared_ptr_Promise_std__string___(__exceptionPtr)
     }
   }
+  
+  @inline(__always)
+  public final func getAndroidChannel() -> bridge.Result_AndroidChannel_ {
+    do {
+      let __result = try self.__implementation.getAndroidChannel()
+      let __resultCpp = __result
+      return bridge.create_Result_AndroidChannel_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_AndroidChannel_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func getInstallerPackageName() -> bridge.Result_InstallerPackageName_ {
+    do {
+      let __result = try self.__implementation.getInstallerPackageName()
+      let __resultCpp = __result
+      return bridge.create_Result_InstallerPackageName_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_InstallerPackageName_(__exceptionPtr)
+    }
+  }
 }

package/nitrogen/generated/ios/swift/InstallerPackageName.swift

@@ -0,0 +1,56 @@
+///
+/// InstallerPackageName.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+/**
+ * Represents the JS union `InstallerPackageName`, backed by a C++ enum.
+ */
+public typealias InstallerPackageName = margelo.nitro.reactnativedeviceutils.InstallerPackageName
+
+public extension InstallerPackageName {
+  /**
+   * Get a InstallerPackageName for the given String value, or
+   * return `nil` if the given value was invalid/unknown.
+   */
+  init?(fromString string: String) {
+    switch string {
+      case "unknown":
+        self = .unknown
+      case "appStore":
+        self = .appstore
+      case "testFlight":
+        self = .testflight
+      case "other":
+        self = .other
+      case "playStore":
+        self = .playstore
+      case "huaweiAppGallery":
+        self = .huaweiappgallery
+      default:
+        return nil
+    }
+  }
+
+  /**
+   * Get the String value this InstallerPackageName represents.
+   */
+  var stringValue: String {
+    switch self {
+      case .unknown:
+        return "unknown"
+      case .appstore:
+        return "appStore"
+      case .testflight:
+        return "testFlight"
+      case .other:
+        return "other"
+      case .playstore:
+        return "playStore"
+      case .huaweiappgallery:
+        return "huaweiAppGallery"
+    }
+  }
+}

package/nitrogen/generated/shared/c++/AndroidChannel.hpp

@@ -0,0 +1,84 @@
+///
+/// AndroidChannel.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::reactnativedeviceutils {
+
+  /**
+   * An enum which can be represented as a JavaScript union (AndroidChannel).
+   */
+  enum class AndroidChannel {
+    DIRECT      SWIFT_NAME(direct) = 0,
+    GOOGLE      SWIFT_NAME(google) = 1,
+    HUAWEI      SWIFT_NAME(huawei) = 2,
+    UNKNOWN      SWIFT_NAME(unknown) = 3,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::reactnativedeviceutils
+
+namespace margelo::nitro {
+
+  // C++ AndroidChannel <> JS AndroidChannel (union)
+  template <>
+  struct JSIConverter<margelo::nitro::reactnativedeviceutils::AndroidChannel> final {
+    static inline margelo::nitro::reactnativedeviceutils::AndroidChannel fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("direct"): return margelo::nitro::reactnativedeviceutils::AndroidChannel::DIRECT;
+        case hashString("google"): return margelo::nitro::reactnativedeviceutils::AndroidChannel::GOOGLE;
+        case hashString("huawei"): return margelo::nitro::reactnativedeviceutils::AndroidChannel::HUAWEI;
+        case hashString("unknown"): return margelo::nitro::reactnativedeviceutils::AndroidChannel::UNKNOWN;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum AndroidChannel - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::reactnativedeviceutils::AndroidChannel arg) {
+      switch (arg) {
+        case margelo::nitro::reactnativedeviceutils::AndroidChannel::DIRECT: return JSIConverter<std::string>::toJSI(runtime, "direct");
+        case margelo::nitro::reactnativedeviceutils::AndroidChannel::GOOGLE: return JSIConverter<std::string>::toJSI(runtime, "google");
+        case margelo::nitro::reactnativedeviceutils::AndroidChannel::HUAWEI: return JSIConverter<std::string>::toJSI(runtime, "huawei");
+        case margelo::nitro::reactnativedeviceutils::AndroidChannel::UNKNOWN: return JSIConverter<std::string>::toJSI(runtime, "unknown");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert AndroidChannel to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("direct"):
+        case hashString("google"):
+        case hashString("huawei"):
+        case hashString("unknown"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/HybridReactNativeDeviceUtilsSpec.cpp

@@ -37,6 +37,8 @@ namespace margelo::nitro::reactnativedeviceutils {
       prototype.registerHybridMethod("incrementConsecutiveBootFailCount", &HybridReactNativeDeviceUtilsSpec::incrementConsecutiveBootFailCount);
       prototype.registerHybridMethod("setConsecutiveBootFailCount", &HybridReactNativeDeviceUtilsSpec::setConsecutiveBootFailCount);
       prototype.registerHybridMethod("getAndClearRecoveryAction", &HybridReactNativeDeviceUtilsSpec::getAndClearRecoveryAction);
+      prototype.registerHybridMethod("getAndroidChannel", &HybridReactNativeDeviceUtilsSpec::getAndroidChannel);
+      prototype.registerHybridMethod("getInstallerPackageName", &HybridReactNativeDeviceUtilsSpec::getInstallerPackageName);
     });
   }
 

package/nitrogen/generated/shared/c++/HybridReactNativeDeviceUtilsSpec.hpp

@@ -23,6 +23,10 @@ namespace margelo::nitro::reactnativedeviceutils { struct LaunchOptions; }
 namespace margelo::nitro::reactnativedeviceutils { struct WebViewPackageInfo; }
 // Forward declaration of `GooglePlayServicesStatus` to properly resolve imports.
 namespace margelo::nitro::reactnativedeviceutils { struct GooglePlayServicesStatus; }
+// Forward declaration of `AndroidChannel` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class AndroidChannel; }
+// Forward declaration of `InstallerPackageName` to properly resolve imports.
+namespace margelo::nitro::reactnativedeviceutils { enum class InstallerPackageName; }
 
 #include "DualScreenInfoRect.hpp"
 #include <vector>
@@ -33,6 +37,8 @@ namespace margelo::nitro::reactnativedeviceutils { struct GooglePlayServicesStat
 #include <string>
 #include "WebViewPackageInfo.hpp"
 #include "GooglePlayServicesStatus.hpp"
+#include "AndroidChannel.hpp"
+#include "InstallerPackageName.hpp"
 
 namespace margelo::nitro::reactnativedeviceutils {
 
@@ -88,6 +94,8 @@ namespace margelo::nitro::reactnativedeviceutils {
       virtual void incrementConsecutiveBootFailCount() = 0;
       virtual void setConsecutiveBootFailCount(double count) = 0;
       virtual std::shared_ptr<Promise<std::string>> getAndClearRecoveryAction() = 0;
+      virtual AndroidChannel getAndroidChannel() = 0;
+      virtual InstallerPackageName getInstallerPackageName() = 0;
 
     protected:
       // Hybrid Setup

package/nitrogen/generated/shared/c++/InstallerPackageName.hpp

@@ -0,0 +1,92 @@
+///
+/// InstallerPackageName.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::reactnativedeviceutils {
+
+  /**
+   * An enum which can be represented as a JavaScript union (InstallerPackageName).
+   */
+  enum class InstallerPackageName {
+    UNKNOWN      SWIFT_NAME(unknown) = 0,
+    APPSTORE      SWIFT_NAME(appstore) = 1,
+    TESTFLIGHT      SWIFT_NAME(testflight) = 2,
+    OTHER      SWIFT_NAME(other) = 3,
+    PLAYSTORE      SWIFT_NAME(playstore) = 4,
+    HUAWEIAPPGALLERY      SWIFT_NAME(huaweiappgallery) = 5,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::reactnativedeviceutils
+
+namespace margelo::nitro {
+
+  // C++ InstallerPackageName <> JS InstallerPackageName (union)
+  template <>
+  struct JSIConverter<margelo::nitro::reactnativedeviceutils::InstallerPackageName> final {
+    static inline margelo::nitro::reactnativedeviceutils::InstallerPackageName fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("unknown"): return margelo::nitro::reactnativedeviceutils::InstallerPackageName::UNKNOWN;
+        case hashString("appStore"): return margelo::nitro::reactnativedeviceutils::InstallerPackageName::APPSTORE;
+        case hashString("testFlight"): return margelo::nitro::reactnativedeviceutils::InstallerPackageName::TESTFLIGHT;
+        case hashString("other"): return margelo::nitro::reactnativedeviceutils::InstallerPackageName::OTHER;
+        case hashString("playStore"): return margelo::nitro::reactnativedeviceutils::InstallerPackageName::PLAYSTORE;
+        case hashString("huaweiAppGallery"): return margelo::nitro::reactnativedeviceutils::InstallerPackageName::HUAWEIAPPGALLERY;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum InstallerPackageName - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::reactnativedeviceutils::InstallerPackageName arg) {
+      switch (arg) {
+        case margelo::nitro::reactnativedeviceutils::InstallerPackageName::UNKNOWN: return JSIConverter<std::string>::toJSI(runtime, "unknown");
+        case margelo::nitro::reactnativedeviceutils::InstallerPackageName::APPSTORE: return JSIConverter<std::string>::toJSI(runtime, "appStore");
+        case margelo::nitro::reactnativedeviceutils::InstallerPackageName::TESTFLIGHT: return JSIConverter<std::string>::toJSI(runtime, "testFlight");
+        case margelo::nitro::reactnativedeviceutils::InstallerPackageName::OTHER: return JSIConverter<std::string>::toJSI(runtime, "other");
+        case margelo::nitro::reactnativedeviceutils::InstallerPackageName::PLAYSTORE: return JSIConverter<std::string>::toJSI(runtime, "playStore");
+        case margelo::nitro::reactnativedeviceutils::InstallerPackageName::HUAWEIAPPGALLERY: return JSIConverter<std::string>::toJSI(runtime, "huaweiAppGallery");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert InstallerPackageName to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("unknown"):
+        case hashString("appStore"):
+        case hashString("testFlight"):
+        case hashString("other"):
+        case hashString("playStore"):
+        case hashString("huaweiAppGallery"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-device-utils",
-  "version": "3.0.18",
+  "version": "3.0.20",
   "description": "react-native-device-utils",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/ReactNativeDeviceUtils.nitro.ts

@@ -3,6 +3,20 @@ import type { HybridObject } from 'react-native-nitro-modules';
 
 export type UserInterfaceStyle = 'light' | 'dark' | 'unspecified';
 
+export type AndroidChannel =
+  | 'direct'
+  | 'google'
+  | 'huawei'
+  | 'unknown';
+
+export type InstallerPackageName =
+  | 'appStore'
+  | 'testFlight'
+  | 'other'
+  | 'playStore'
+  | 'huaweiAppGallery'
+  | 'unknown';
+
 export interface DualScreenInfoRect {
   x: number;
   y: number;
@@ -59,4 +73,8 @@ export interface ReactNativeDeviceUtils
   incrementConsecutiveBootFailCount(): void;
   setConsecutiveBootFailCount(count: number): void;
   getAndClearRecoveryAction(): Promise<string>;
+
+  // Android Channel & Installer
+  getAndroidChannel(): AndroidChannel;
+  getInstallerPackageName(): InstallerPackageName;
 }