react-native-device-secure-info 1.0.0

package/README.md

@@ -0,0 +1,175 @@
+# react-native-device-secure-info
+
+一个 React Native 原生模块，用于获取设备安全信息，包括设备基础信息、内存、CPU 和电池状态。同时支持**新架构（TurboModule）**和**旧架构（Bridge）**。
+
+## 截图
+
+<p align="center">
+  <img src="src/assets/image.png" alt="Demo Screenshot" width="300" />
+</p>
+
+## 功能特性
+
+- 📱 **基础设备信息** — 设备名称、系统版本、品牌、制造商、设备型号、设备 ID、运营商、SDK 版本
+- 💾 **内存信息** — 总内存、可用内存、已用内存、内存使用率
+- ⚙️ **CPU 信息** — CPU 架构、核心数、使用率
+- 🔋 **电池信息** — 电量百分比、充电状态、是否正在充电
+- 🚀 **双架构支持** — 自动适配新架构（TurboModule）和旧架构（Bridge）
+- 📦 **TypeScript 支持** — 完整的类型定义
+
+## 平台支持
+
+| 平台 | 支持 |
+| --- | --- |
+| iOS | ✅ |
+| Android | ✅ |
+
+## 环境要求
+
+- React Native >= 0.71.0
+- React >= 18.0.0
+- iOS >= 13.4
+- Android minSdkVersion >= 21
+
+## 安装
+
+```bash
+npm install react-native-device-secure-info
+# 或
+yarn add react-native-device-secure-info
+```
+
+### iOS
+
+```bash
+cd ios && pod install
+```
+
+### Android
+
+无需额外配置，React Native CLI 的 autolinking 会自动完成链接。
+
+## 使用方式
+
+```typescript
+import { getDeviceInfo } from 'react-native-device-secure-info';
+
+async function fetchInfo() {
+  const info = await getDeviceInfo();
+
+  // 基础设备信息
+  console.log('设备名称:', info.deviceName);
+  console.log('系统:', info.systemName, info.systemVersion);
+  console.log('品牌:', info.brand);
+  console.log('制造商:', info.manufacturer);
+  console.log('设备型号:', info.deviceModel);
+  console.log('设备ID:', info.deviceId);
+  console.log('运营商:', info.carrierName);
+
+  // 内存信息
+  console.log('总内存:', info.totalMemory);
+  console.log('可用内存:', info.availableMemory);
+  console.log('内存使用率:', info.memoryUsagePercent + '%');
+
+  // CPU 信息
+  console.log('CPU架构:', info.cpuArchitecture);
+  console.log('CPU核心数:', info.cpuCores);
+  console.log('CPU使用率:', info.cpuUsagePercent + '%');
+
+  // 电池信息
+  console.log('电量:', info.batteryLevel + '%');
+  console.log('充电状态:', info.batteryState);
+  console.log('正在充电:', info.isCharging);
+}
+```
+
+## API
+
+### `getDeviceInfo(): Promise<DeviceSecureInfo>`
+
+获取设备安全信息，返回一个 Promise，resolve 后得到 `DeviceSecureInfo` 对象。
+
+### DeviceSecureInfo 类型定义
+
+```typescript
+interface DeviceSecureInfo {
+  // ---- 基础设备信息 ----
+  deviceName: string;        // 设备名称（如 "iPhone 17 Pro"）
+  systemVersion: string;     // 系统版本号（如 "26.2" / "14"）
+  brand: string;             // 设备品牌（如 "Apple" / "Samsung"）
+  manufacturer: string;      // 制造商（如 "Apple" / "Xiaomi"）
+  deviceId: string;          // 设备唯一标识
+  carrierName: string;       // 运营商名称（如 "中国移动"）
+  sdkVersion: number;        // SDK 版本号
+  deviceModel: string;       // 设备型号（如 "iPhone14,2" / "arm64"）
+  systemName: string;        // 系统名称（如 "iOS" / "Android"）
+
+  // ---- 内存信息 ----
+  totalMemory: number;       // 总内存（字节）
+  availableMemory: number;   // 可用内存（字节）
+  usedMemory: number;        // 已使用内存（字节）
+  memoryUsagePercent: number; // 内存使用百分比
+
+  // ---- CPU 信息 ----
+  cpuArchitecture: string;   // CPU 架构（如 "arm64"）
+  cpuCores: number;          // CPU 核心数
+  cpuUsagePercent: number;   // CPU 使用率百分比
+
+  // ---- 电池信息 ----
+  batteryLevel: number;      // 电池电量百分比（0-100，-1 表示未知）
+  batteryState: string;      // 电池状态（"charging" / "discharging" / "full" / "unknown"）
+  isCharging: boolean;       // 是否正在充电
+}
+```
+
+## 架构说明
+
+本模块同时支持 React Native 新架构和旧架构：
+
+| 架构 | 实现方式 | 说明 |
+| --- | --- | --- |
+| 新架构 | TurboModule + Codegen | 通过 `TurboModuleRegistry` 自动注册，性能更优 |
+| 旧架构 | NativeModules (Bridge) | 通过 `NativeModules.DeviceSecureInfoModule` 获取 |
+
+模块入口（`src/index.ts`）会自动检测当前架构并选择对应的实现，使用者无需关心底层差异。
+
+## 项目结构
+
+```
+react-native-device-secure-info/
+├── src/
+│   ├── index.ts                        # JS 入口，自动适配新旧架构
+│   └── NativeDeviceSecureInfo.ts       # TurboModule Spec 定义（Codegen）
+├── ios/
+│   ├── DeviceSecureInfoModule.h        # iOS 旧架构头文件
+│   ├── DeviceSecureInfoModule.m        # iOS 旧架构实现（Bridge）
+│   ├── DeviceSecureInfoTurboModule.h   # iOS 新架构头文件
+│   └── DeviceSecureInfoTurboModule.mm  # iOS 新架构实现（TurboModule）
+├── android/
+│   └── app/src/main/java/...
+│       ├── DeviceSecureInfoModule.kt   # Android 原生模块实现
+│       └── DeviceSecureInfoPackage.kt  # Android Package 注册
+├── react-native-device-secure-info.podspec  # iOS CocoaPods 配置
+├── react-native.config.js              # React Native autolinking 配置
+└── package.json
+```
+
+## 本地开发
+
+### 运行 Demo App
+
+```bash
+# 安装依赖
+npm install
+
+# iOS
+cd ios && pod install && cd ..
+npm run ios
+
+# Android
+npm run android
+```
+
+## License
+
+MIT

package/android/app/build.gradle

@@ -0,0 +1,119 @@
+apply plugin: "com.android.application"
+apply plugin: "org.jetbrains.kotlin.android"
+apply plugin: "com.facebook.react"
+
+/**
+ * This is the configuration block to customize your React Native Android app.
+ * By default you don't need to apply any configuration, just uncomment the lines you need.
+ */
+react {
+    /* Folders */
+    //   The root of your project, i.e. where "package.json" lives. Default is '../..'
+    // root = file("../../")
+    //   The folder where the react-native NPM package is. Default is ../../node_modules/react-native
+    // reactNativeDir = file("../../node_modules/react-native")
+    //   The folder where the react-native Codegen package is. Default is ../../node_modules/@react-native/codegen
+    // codegenDir = file("../../node_modules/@react-native/codegen")
+    //   The cli.js file which is the React Native CLI entrypoint. Default is ../../node_modules/react-native/cli.js
+    // cliFile = file("../../node_modules/react-native/cli.js")
+
+    /* Variants */
+    //   The list of variants to that are debuggable. For those we're going to
+    //   skip the bundling of the JS bundle and the assets. By default is just 'debug'.
+    //   If you add flavors like lite, prod, etc. you'll have to list your debuggableVariants.
+    // debuggableVariants = ["liteDebug", "prodDebug"]
+
+    /* Bundling */
+    //   A list containing the node command and its flags. Default is just 'node'.
+    // nodeExecutableAndArgs = ["node"]
+    //
+    //   The command to run when bundling. By default is 'bundle'
+    // bundleCommand = "ram-bundle"
+    //
+    //   The path to the CLI configuration file. Default is empty.
+    // bundleConfig = file(../rn-cli.config.js)
+    //
+    //   The name of the generated asset file containing your JS bundle
+    // bundleAssetName = "MyApplication.android.bundle"
+    //
+    //   The entry file for bundle generation. Default is 'index.android.js' or 'index.js'
+    // entryFile = file("../js/MyApplication.android.js")
+    //
+    //   A list of extra flags to pass to the 'bundle' commands.
+    //   See https://github.com/react-native-community/cli/blob/main/docs/commands.md#bundle
+    // extraPackagerArgs = []
+
+    /* Hermes Commands */
+    //   The hermes compiler command to run. By default it is 'hermesc'
+    // hermesCommand = "$rootDir/my-custom-hermesc/bin/hermesc"
+    //
+    //   The list of flags to pass to the Hermes compiler. By default is "-O", "-output-source-map"
+    // hermesFlags = ["-O", "-output-source-map"]
+
+    /* Autolinking */
+    autolinkLibrariesWithApp()
+}
+
+/**
+ * Set this to true to Run Proguard on Release builds to minify the Java bytecode.
+ */
+def enableProguardInReleaseBuilds = false
+
+/**
+ * The preferred build flavor of JavaScriptCore (JSC)
+ *
+ * For example, to use the international variant, you can use:
+ * `def jscFlavor = io.github.react-native-community:jsc-android-intl:2026004.+`
+ *
+ * The international variant includes ICU i18n library and necessary data
+ * allowing to use e.g. `Date.toLocaleString` and `String.localeCompare` that
+ * give correct results when using with locales other than en-US. Note that
+ * this variant is about 6MiB larger per architecture than default.
+ */
+def jscFlavor = 'io.github.react-native-community:jsc-android:2026004.+'
+
+android {
+    ndkVersion rootProject.ext.ndkVersion
+    buildToolsVersion rootProject.ext.buildToolsVersion
+    compileSdk rootProject.ext.compileSdkVersion
+
+    namespace "com.reactnativedevicesecureinfo"
+    defaultConfig {
+        applicationId "com.reactnativedevicesecureinfo"
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+        versionCode 1
+        versionName "1.0"
+    }
+    signingConfigs {
+        debug {
+            storeFile file('debug.keystore')
+            storePassword 'android'
+            keyAlias 'androiddebugkey'
+            keyPassword 'android'
+        }
+    }
+    buildTypes {
+        debug {
+            signingConfig signingConfigs.debug
+        }
+        release {
+            // Caution! In production, you need to generate your own keystore file.
+            // see https://reactnative.dev/docs/signed-apk-android.
+            signingConfig signingConfigs.debug
+            minifyEnabled enableProguardInReleaseBuilds
+            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
+        }
+    }
+}
+
+dependencies {
+    // The version of react-native is set by the React Native Gradle Plugin
+    implementation("com.facebook.react:react-android")
+
+    if (hermesEnabled.toBoolean()) {
+        implementation("com.facebook.react:hermes-android")
+    } else {
+        implementation jscFlavor
+    }
+}

package/android/app/proguard-rules.pro

@@ -0,0 +1,10 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in /usr/local/Cellar/android-sdk/24.3.3/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:

package/android/app/src/debug/AndroidManifest.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <application
+        android:usesCleartextTraffic="true"
+        tools:targetApi="28"
+        tools:ignore="GoogleAppIndexingWarning"/>
+</manifest>

package/android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,26 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+      android:name=".MainApplication"
+      android:label="@string/app_name"
+      android:icon="@mipmap/ic_launcher"
+      android:roundIcon="@mipmap/ic_launcher_round"
+      android:allowBackup="false"
+      android:theme="@style/AppTheme"
+      android:supportsRtl="true">
+      <activity
+        android:name=".MainActivity"
+        android:label="@string/app_name"
+        android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
+        android:launchMode="singleTask"
+        android:windowSoftInputMode="adjustResize"
+        android:exported="true">
+        <intent-filter>
+            <action android:name="android.intent.action.MAIN" />
+            <category android:name="android.intent.category.LAUNCHER" />
+        </intent-filter>
+      </activity>
+    </application>
+</manifest>

package/android/app/src/main/java/com/reactnativedevicesecureinfo/DeviceSecureInfoModule.kt

@@ -0,0 +1,167 @@
+package com.reactnativedevicesecureinfo
+
+// Android 旧架构（Bridge）设备安全信息模块
+
+import android.app.ActivityManager
+import android.content.Context
+import android.content.Intent
+import android.content.IntentFilter
+import android.os.BatteryManager
+import android.os.Build
+import android.provider.Settings
+import android.telephony.TelephonyManager
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.bridge.WritableNativeMap
+import com.facebook.react.bridge.Promise
+import java.io.RandomAccessFile
+
+/**
+ * 设备安全信息原生模块（旧架构 Bridge 版本）
+ *
+ * 提供设备基础信息、内存、CPU、电池等信息
+ * 通过 ReactPackage 注册到 RN Bridge 中
+ */
+class DeviceSecureInfoModule(reactContext: ReactApplicationContext) :
+    ReactContextBaseJavaModule(reactContext) {
+
+    override fun getName(): String = NAME
+
+    companion object {
+        const val NAME = "DeviceSecureInfoModule"
+    }
+
+    /**
+     * 获取完整的设备安全信息
+     * 通过 Promise 返回给 JS 层
+     */
+    @ReactMethod
+    fun getDeviceInfo(promise: Promise) {
+        try {
+            val context = reactApplicationContext
+            val telephonyManager =
+                context.getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
+
+            val deviceInfo: WritableMap = WritableNativeMap()
+
+            // ---- 基础设备信息 ----
+            deviceInfo.putString("deviceName", Build.MODEL)
+            deviceInfo.putString("systemVersion", Build.VERSION.RELEASE)
+            deviceInfo.putString("brand", Build.BRAND)
+            deviceInfo.putString("manufacturer", Build.MANUFACTURER)
+            deviceInfo.putString(
+                "deviceId",
+                Settings.Secure.getString(context.contentResolver, Settings.Secure.ANDROID_ID)
+            )
+            deviceInfo.putString("carrierName", telephonyManager.networkOperatorName)
+            deviceInfo.putInt("sdkVersion", Build.VERSION.SDK_INT)
+            deviceInfo.putString("deviceModel", Build.DEVICE)
+            deviceInfo.putString("systemName", "Android")
+
+            // ---- 内存信息 ----
+            val activityManager =
+                context.getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
+            val memoryInfo = ActivityManager.MemoryInfo()
+            activityManager.getMemoryInfo(memoryInfo)
+
+            val totalMemory = memoryInfo.totalMem
+            val availableMemory = memoryInfo.availMem
+            val usedMemory = totalMemory - availableMemory
+            val memoryUsagePercent = if (totalMemory > 0) {
+                (usedMemory.toDouble() / totalMemory.toDouble() * 100).toInt()
+            } else 0
+
+            deviceInfo.putDouble("totalMemory", totalMemory.toDouble())
+            deviceInfo.putDouble("availableMemory", availableMemory.toDouble())
+            deviceInfo.putDouble("usedMemory", usedMemory.toDouble())
+            deviceInfo.putInt("memoryUsagePercent", memoryUsagePercent)
+
+            // ---- CPU 信息 ----
+            deviceInfo.putString(
+                "cpuArchitecture",
+                Build.SUPPORTED_ABIS.firstOrNull() ?: "unknown"
+            )
+            deviceInfo.putInt("cpuCores", Runtime.getRuntime().availableProcessors())
+            deviceInfo.putDouble("cpuUsagePercent", getCpuUsagePercent())
+
+            // ---- 电池信息 ----
+            val batteryIntent =
+                context.registerReceiver(null, IntentFilter(Intent.ACTION_BATTERY_CHANGED))
+            if (batteryIntent != null) {
+                val level = batteryIntent.getIntExtra(BatteryManager.EXTRA_LEVEL, -1)
+                val scale = batteryIntent.getIntExtra(BatteryManager.EXTRA_SCALE, -1)
+                val batteryLevel = if (level >= 0 && scale > 0) {
+                    (level.toDouble() / scale.toDouble() * 100).toInt()
+                } else -1
+
+                val status = batteryIntent.getIntExtra(BatteryManager.EXTRA_STATUS, -1)
+                val isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING ||
+                    status == BatteryManager.BATTERY_STATUS_FULL
+                val batteryState = when (status) {
+                    BatteryManager.BATTERY_STATUS_CHARGING -> "charging"
+                    BatteryManager.BATTERY_STATUS_DISCHARGING -> "discharging"
+                    BatteryManager.BATTERY_STATUS_FULL -> "full"
+                    BatteryManager.BATTERY_STATUS_NOT_CHARGING -> "discharging"
+                    else -> "unknown"
+                }
+
+                deviceInfo.putInt("batteryLevel", batteryLevel)
+                deviceInfo.putString("batteryState", batteryState)
+                deviceInfo.putBoolean("isCharging", isCharging)
+            } else {
+                deviceInfo.putInt("batteryLevel", -1)
+                deviceInfo.putString("batteryState", "unknown")
+                deviceInfo.putBoolean("isCharging", false)
+            }
+
+            promise.resolve(deviceInfo)
+        } catch (e: Exception) {
+            promise.reject("DEVICE_INFO_ERROR", "获取设备信息失败: ${e.message}", e)
+        }
+    }
+
+    /**
+     * 读取 /proc/stat 获取 CPU 使用率
+     * 通过两次采样间隔 100ms 计算实时 CPU 使用百分比
+     */
+    private fun getCpuUsagePercent(): Double {
+        try {
+            val reader1 = RandomAccessFile("/proc/stat", "r")
+            val line1 = reader1.readLine()
+            reader1.close()
+
+            Thread.sleep(100)
+
+            val reader2 = RandomAccessFile("/proc/stat", "r")
+            val line2 = reader2.readLine()
+            reader2.close()
+
+            val cpu1 = parseCpuLine(line1)
+            val cpu2 = parseCpuLine(line2)
+
+            if (cpu1 != null && cpu2 != null) {
+                val totalDiff = cpu2.total - cpu1.total
+                val idleDiff = cpu2.idle - cpu1.idle
+                if (totalDiff > 0) {
+                    return ((totalDiff - idleDiff).toDouble() / totalDiff.toDouble() * 100)
+                }
+            }
+        } catch (e: Exception) {
+            // /proc/stat 可能在某些设备上无法读取
+        }
+        return -1.0
+    }
+
+    private data class CpuStat(val total: Long, val idle: Long)
+
+    private fun parseCpuLine(line: String): CpuStat? {
+        val parts = line.trim().split("\\s+".toRegex())
+        if (parts.size < 5 || parts[0] != "cpu") return null
+        val values = parts.drop(1).map { it.toLongOrNull() ?: 0L }
+        val total = values.sum()
+        val idle = values.getOrElse(3) { 0L }
+        return CpuStat(total, idle)
+    }
+}

package/android/app/src/main/java/com/reactnativedevicesecureinfo/DeviceSecureInfoPackage.kt

@@ -0,0 +1,22 @@
+package com.reactnativedevicesecureinfo
+
+// 旧架构 ReactPackage —— 用于注册 DeviceSecureInfoModule 到 Bridge
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+/**
+ * 旧架构下的 ReactPackage
+ * 在 MainApplication 的 getPackages() 中注册
+ */
+class DeviceSecureInfoPackage : ReactPackage {
+    override fun createNativeModules(reactContext: ReactApplicationContext): MutableList<NativeModule> {
+        return mutableListOf(DeviceSecureInfoModule(reactContext))
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): MutableList<ViewManager<*, *>> {
+        return mutableListOf()
+    }
+}