react-native-device-secure-info 1.0.0

package/react-native-device-secure-info.podspec

@@ -0,0 +1,20 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-device-secure-info"
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.homepage     = package['repository']['url']
+  s.license      = package['license']
+  s.authors      = package['author']
+  s.platforms    = { ios: '13.4' }
+  s.source       = { git: package['repository']['url'], tag: s.version.to_s }
+
+  # 源文件路径
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  # 如果新架构启用，安装 codegen 相关依赖
+  install_modules_dependencies(s)
+end

package/react-native.config.js

@@ -0,0 +1,13 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        sourceDir: './android',
+        packageImportPath: 'import com.reactnativedevicesecureinfo.DeviceSecureInfoPackage;',
+      },
+      ios: {
+        podspecPath: './react-native-device-secure-info.podspec',
+      },
+    },
+  },
+};

package/src/NativeDeviceSecureInfo.ts

@@ -0,0 +1,67 @@
+// NativeDeviceSecureInfo.ts
+// RN 新架构 TurboModule Spec 定义
+// 文件名必须以 Native 开头，用于 Codegen 自动生成接口代码
+
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+/**
+ * 设备安全信息接口（Codegen 要求返回类型必须显式定义）
+ */
+export interface DeviceSecureInfo {
+  // ---- 基础设备信息 ----
+  /** 设备名称（如 "iPhone 15 Pro"） */
+  deviceName: string;
+  /** 系统版本号（如 "17.4.1" / "14"） */
+  systemVersion: string;
+  /** 设备品牌（如 "Apple" / "Samsung"） */
+  brand: string;
+  /** 制造商（如 "Apple" / "Xiaomi"） */
+  manufacturer: string;
+  /** 设备唯一标识（iOS: identifierForVendor, Android: ANDROID_ID） */
+  deviceId: string;
+  /** 运营商名称（如 "中国移动"） */
+  carrierName: string;
+  /** SDK 版本号 */
+  sdkVersion: number;
+  /** 设备型号（如 "iPhone14,2" / "oriole"） */
+  deviceModel: string;
+  /** 系统名称（如 "iOS" / "Android"） */
+  systemName: string;
+
+  // ---- 内存信息 ----
+  /** 总内存（字节） */
+  totalMemory: number;
+  /** 可用内存（字节） */
+  availableMemory: number;
+  /** 已使用内存（字节） */
+  usedMemory: number;
+  /** 内存使用百分比 */
+  memoryUsagePercent: number;
+
+  // ---- CPU 信息 ----
+  /** CPU 架构（如 "arm64-v8a"、"arm64e"、"arm64"） */
+  cpuArchitecture: string;
+  /** CPU 核心数 */
+  cpuCores: number;
+  /** CPU 使用率百分比 */
+  cpuUsagePercent: number;
+
+  // ---- 电池信息 ----
+  /** 电池电量百分比（0-100，-1 表示未知） */
+  batteryLevel: number;
+  /** 电池状态（"charging" / "discharging" / "full" / "unknown"） */
+  batteryState: string;
+  /** 是否正在充电 */
+  isCharging: boolean;
+}
+
+/**
+ * TurboModule 规范接口
+ * 新架构下由 Codegen 生成对应的原生接口
+ */
+export interface Spec extends TurboModule {
+  getDeviceInfo(): Promise<DeviceSecureInfo>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('DeviceSecureInfoModule');

package/src/index.ts

@@ -0,0 +1,90 @@
+/**
+ * react-native-device-secure-info
+ *
+ * 获取设备安全信息的 React Native 原生模块
+ * 同时支持新架构（TurboModule）和旧架构（Bridge）
+ *
+ * 使用方式：
+ * ```ts
+ * import { getDeviceInfo } from 'react-native-device-secure-info';
+ *
+ * const info = await getDeviceInfo();
+ * console.log(info.deviceName, info.batteryLevel);
+ * ```
+ */
+
+import { NativeModules, Platform } from 'react-native';
+import type { DeviceSecureInfo } from './NativeDeviceSecureInfo';
+
+// 导出类型供外部使用
+export type { DeviceSecureInfo } from './NativeDeviceSecureInfo';
+
+// ===================================================================
+// 自动选择模块：优先新架构 TurboModule，回退旧架构 Bridge
+// ===================================================================
+
+const isTurboModuleEnabled = !!(global as any).__turboModuleProxy;
+
+/**
+ * 获取原生模块实例
+ * - 新架构：通过 TurboModuleRegistry 获取（import 时自动触发）
+ * - 旧架构：通过 NativeModules.DeviceSecureInfoModule 获取
+ */
+function getDeviceSecureInfoModule() {
+  if (isTurboModuleEnabled) {
+    // 新架构：使用 TurboModule
+    try {
+      return require('./NativeDeviceSecureInfo').default;
+    } catch (e) {
+      console.warn(
+        '[react-native-device-secure-info] TurboModule not available, falling back to Bridge module',
+      );
+    }
+  }
+
+  // 旧架构：使用 NativeModules (Bridge)
+  const { DeviceSecureInfoModule } = NativeModules;
+  if (!DeviceSecureInfoModule) {
+    throw new Error(
+      '[react-native-device-secure-info] Native module not found. ' +
+        'Please make sure the native module is properly linked:\n' +
+        '  - Android: Check MainApplication.kt/MainApplication.java\n' +
+        '  - iOS: Run `cd ios && pod install`\n' +
+        `  - Platform: ${Platform.OS}`,
+    );
+  }
+  return DeviceSecureInfoModule;
+}
+
+// 缓存模块实例
+const DeviceSecureInfoNativeModule = getDeviceSecureInfoModule();
+
+/**
+ * 获取设备安全信息
+ *
+ * 返回设备的基础信息、内存信息、CPU 信息和电池信息
+ *
+ * @returns {Promise<DeviceSecureInfo>} 设备信息对象
+ *
+ * @example
+ * ```tsx
+ * 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.batteryLevel + '%');
+ *   console.log('内存使用:', info.memoryUsagePercent + '%');
+ *   console.log('CPU核心:', info.cpuCores);
+ * }
+ * ```
+ */
+export function getDeviceInfo(): Promise<DeviceSecureInfo> {
+  return DeviceSecureInfoNativeModule.getDeviceInfo();
+}
+
+/**
+ * 默认导出模块实例（高级用法）
+ */
+export default DeviceSecureInfoNativeModule;