@jincheng_1995/react-native-device-info-plus 1.0.0

package/PUBLISHING.md

@@ -0,0 +1,385 @@
+# 发布指南
+
+本文档说明如何将 React Native 插件发布到 npm 和 GitHub。
+
+## 📋 发布前准备
+
+### 1. 完善 package.json
+
+确保以下信息正确：
+
+```json
+{
+  "name": "react-native-device-info-plus",
+  "version": "1.0.0",
+  "description": "一个全面的 React Native 设备信息和操作模块",
+  "author": "你的名字 <你的邮箱@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/你的用户名/react-native-device-info-plus.git"
+  },
+  "bugs": {
+    "url": "https://github.com/你的用户名/react-native-device-info-plus/issues"
+  },
+  "homepage": "https://github.com/你的用户名/react-native-device-info-plus#readme"
+}
+```
+
+### 2. 检查 .npmignore
+
+确保不发布不必要的文件：
+
+```
+# .npmignore
+example/
+node_modules/
+src/
+*.log
+.vscode/
+.idea/
+.DS_Store
+tsconfig.json
+.eslintrc.js
+```
+
+### 3. 构建项目
+
+```bash
+npm run prepare
+```
+
+确保 `lib/` 目录生成成功。
+
+### 4. 测试
+
+```bash
+# 类型检查
+npm run typescript
+
+# 代码检查
+npm run lint
+```
+
+---
+
+## 🐙 发布到 GitHub
+
+### 步骤 1: 创建 GitHub 仓库
+
+1. 访问 https://github.com/new
+2. 填写仓库信息：
+   - **Repository name**: `react-native-device-info-plus`
+   - **Description**: `一个全面的 React Native 设备信息和操作模块`
+   - **Public** 或 **Private**（推荐 Public）
+   - ❌ 不要勾选 "Initialize with README"（我们已有 README）
+
+### 步骤 2: 初始化 Git
+
+```bash
+# 初始化 Git（如果还没有）
+git init
+
+# 添加所有文件
+git add .
+
+# 提交
+git commit -m "Initial commit: React Native device info plugin"
+```
+
+### 步骤 3: 关联远程仓库
+
+```bash
+# 关联 GitHub 仓库
+git remote add origin https://github.com/你的用户名/react-native-device-info-plus.git
+
+# 推送代码
+git branch -M main
+git push -u origin main
+```
+
+### 步骤 4: 添加标签（可选）
+
+```bash
+# 为版本打标签
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+---
+
+## 📦 发布到 npm
+
+### 步骤 1: 注册 npm 账号
+
+如果还没有 npm 账号：
+
+1. 访问 https://www.npmjs.com/signup
+2. 填写用户名、邮箱、密码
+3. 验证邮箱
+
+### 步骤 2: 登录 npm
+
+```bash
+npm login
+```
+
+输入：
+- Username: 你的 npm 用户名
+- Password: 你的密码
+- Email: 你的邮箱
+
+### 步骤 3: 检查包名是否可用
+
+```bash
+npm search react-native-device-info-plus
+```
+
+如果已存在，需要修改 `package.json` 中的 `name`：
+```json
+{
+  "name": "@你的用户名/react-native-device-info-plus"
+}
+```
+
+### 步骤 4: 发布
+
+```bash
+# 首次发布
+npm publish
+
+# 如果使用了 scope (@你的用户名/xxx)
+npm publish --access public
+```
+
+### 步骤 5: 验证发布
+
+访问 https://www.npmjs.com/package/react-native-device-info-plus
+
+---
+
+## 🔄 更新版本
+
+### 版本号规则（语义化版本）
+
+```
+主版本号.次版本号.修订号
+  1   .   0   .   0
+
+- 主版本号：不兼容的 API 修改
+- 次版本号：向下兼容的功能性新增
+- 修订号：向下兼容的问题修正
+```
+
+### 更新步骤
+
+```bash
+# 1. 修复 bug（修订号 +1）
+npm version patch
+# 1.0.0 → 1.0.1
+
+# 2. 添加新功能（次版本号 +1）
+npm version minor
+# 1.0.1 → 1.1.0
+
+# 3. 重大更新（主版本号 +1）
+npm version major
+# 1.1.0 → 2.0.0
+
+# 4. 推送到 GitHub
+git push origin main --tags
+
+# 5. 重新构建
+npm run prepare
+
+# 6. 发布到 npm
+npm publish
+```
+
+---
+
+## 📝 发布检查清单
+
+### 发布前
+
+- [ ] 更新 `package.json` 中的版本号
+- [ ] 更新 `CHANGELOG.md`（如果有）
+- [ ] 运行 `npm run typescript` 检查类型
+- [ ] 运行 `npm run lint` 检查代码
+- [ ] 运行 `npm run prepare` 构建
+- [ ] 测试在真实项目中的使用
+- [ ] 更新 `README.md` 文档
+- [ ] 检查 `.npmignore` 配置
+
+### 发布后
+
+- [ ] 在 npm 上验证包已发布
+- [ ] 测试安装：`npm install react-native-device-info-plus`
+- [ ] 在 GitHub 上创建 Release
+- [ ] 更新文档网站（如果有）
+- [ ] 通知用户（社交媒体、论坛等）
+
+---
+
+## 🎯 完整发布流程示例
+
+```bash
+# 1. 确保代码已提交
+git status
+
+# 2. 更新版本号
+npm version patch
+
+# 3. 构建
+npm run prepare
+
+# 4. 推送到 GitHub
+git push origin main --tags
+
+# 5. 发布到 npm
+npm publish
+
+# 6. 在 GitHub 创建 Release
+# 访问 https://github.com/你的用户名/react-native-device-info-plus/releases/new
+```
+
+---
+
+## 🔐 私有包发布
+
+如果不想公开发布，可以发布私有包：
+
+### npm 私有包（需要付费）
+
+```bash
+npm publish --access restricted
+```
+
+### GitHub Packages（免费）
+
+1. 修改 `package.json`：
+```json
+{
+  "name": "@你的用户名/react-native-device-info-plus",
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  }
+}
+```
+
+2. 创建 `.npmrc`：
+```
+@你的用户名:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+```
+
+3. 发布：
+```bash
+npm publish
+```
+
+---
+
+## 🚫 取消发布
+
+**注意**：npm 有严格的取消发布政策
+
+```bash
+# 只能取消发布 72 小时内的版本
+npm unpublish react-native-device-info-plus@1.0.0
+
+# 取消整个包（慎用！）
+npm unpublish react-native-device-info-plus --force
+```
+
+**建议**：使用 `npm deprecate` 代替：
+```bash
+npm deprecate react-native-device-info-plus@1.0.0 "此版本有 bug，请使用 1.0.1"
+```
+
+---
+
+## 📊 发布后的维护
+
+### 监控下载量
+
+访问 https://www.npmjs.com/package/react-native-device-info-plus
+
+### 处理 Issues
+
+在 GitHub 上回复用户问题：
+https://github.com/你的用户名/react-native-device-info-plus/issues
+
+### 持续更新
+
+```bash
+# 定期更新依赖
+npm update
+
+# 检查过时的依赖
+npm outdated
+
+# 更新 React Native 版本支持
+npm install react-native@latest --save-peer
+```
+
+---
+
+## 🔗 相关链接
+
+- [npm 文档](https://docs.npmjs.com/)
+- [语义化版本](https://semver.org/lang/zh-CN/)
+- [GitHub Packages](https://docs.github.com/en/packages)
+- [npm 发布最佳实践](https://docs.npmjs.com/packages-and-modules/contributing-packages-to-the-registry)
+
+---
+
+## ❓ 常见问题
+
+### Q: 包名已被占用怎么办？
+
+**A**: 使用 scoped package：
+```json
+{
+  "name": "@你的用户名/react-native-device-info-plus"
+}
+```
+
+### Q: 发布失败提示权限错误？
+
+**A**: 确保已登录：
+```bash
+npm whoami
+npm login
+```
+
+### Q: 如何删除已发布的版本？
+
+**A**: 只能在 72 小时内删除，建议使用 deprecate：
+```bash
+npm deprecate react-native-device-info-plus@1.0.0 "请使用新版本"
+```
+
+### Q: 发布后发现 bug 怎么办？
+
+**A**: 
+1. 修复 bug
+2. 更新版本号：`npm version patch`
+3. 重新发布：`npm publish`
+4. 标记旧版本：`npm deprecate react-native-device-info-plus@1.0.0 "有 bug，请升级"`
+
+---
+
+## 💡 最佳实践
+
+1. **使用语义化版本**：严格遵循 semver 规范
+2. **编写 CHANGELOG**：记录每个版本的变更
+3. **自动化发布**：使用 GitHub Actions 自动发布
+4. **测试后发布**：确保在真实项目中测试过
+5. **文档完善**：提供清晰的 README 和示例
+6. **及时响应**：快速处理 Issues 和 PR
+7. **版本标签**：在 GitHub 上为每个版本打标签
+
+---
+
+**祝发布顺利！** 🎉

package/README.md

@@ -0,0 +1,111 @@
+# react-native-device-info-plus
+
+一个全面的 React Native 设备信息和操作模块，支持新架构（Turbo Modules）。
+
+## 功能特性
+
+### 设备信息
+- 设备型号、品牌、制造商
+- 系统版本
+- 唯一标识符（UUID）
+- 网络状态
+- 电池信息
+- 存储空间
+- 屏幕信息
+
+### 传感器数据
+- 加速度计
+- 陀螺仪
+
+### 设备操作
+- 振动
+- 亮度调节
+- 音量控制
+- 剪贴板操作
+- 打开系统设置
+
+## 安装
+
+```bash
+npm install react-native-device-info-plus
+# 或
+yarn add react-native-device-info-plus
+```
+
+### iOS
+```bash
+cd ios && pod install
+```
+
+## 使用示例
+
+```typescript
+import DeviceInfoPlus from 'react-native-device-info-plus';
+
+// 获取设备信息
+const deviceModel = await DeviceInfoPlus.getDeviceModel();
+const systemVersion = await DeviceInfoPlus.getSystemVersion();
+const uniqueId = await DeviceInfoPlus.getUniqueId();
+
+// 获取电池信息
+const batteryLevel = await DeviceInfoPlus.getBatteryLevel();
+
+// 获取网络状态
+const networkType = await DeviceInfoPlus.getNetworkType();
+
+// 获取存储信息
+const totalStorage = await DeviceInfoPlus.getTotalStorage();
+const freeStorage = await DeviceInfoPlus.getFreeStorage();
+
+// 获取屏幕信息
+const screenInfo = await DeviceInfoPlus.getScreenInfo();
+
+// 振动
+DeviceInfoPlus.vibrate(500); // 振动 500ms
+
+// 设置亮度
+await DeviceInfoPlus.setBrightness(0.8); // 0.0 - 1.0
+
+// 获取亮度
+const brightness = await DeviceInfoPlus.getBrightness();
+
+// 剪贴板操作
+await DeviceInfoPlus.setClipboard('Hello World');
+const text = await DeviceInfoPlus.getClipboard();
+
+// 打开系统设置
+DeviceInfoPlus.openSettings();
+
+// 传感器监听
+const subscription = DeviceInfoPlus.addAccelerometerListener((data) => {
+  console.log('Accelerometer:', data.x, data.y, data.z);
+});
+
+// 取消监听
+subscription.remove();
+```
+
+## 权限配置
+
+### ✅ Android 权限自动配置
+
+插件所需的 Android 权限会**自动合并**到你的应用，无需手动配置。
+
+**⚠️ 注意**: `setBrightness()` 方法需要在运行时请求 `WRITE_SETTINGS` 权限。
+
+### ⚠️ iOS 权限必须手动配置
+
+iOS 不支持权限自动合并，如果使用传感器功能，**必须手动**在 `ios/YourApp/Info.plist` 中添加：
+
+```xml
+<key>NSMotionUsageDescription</key>
+<string>需要访问传感器数据来提供更好的用户体验</string>
+```
+
+**重要**：不添加此配置，传感器功能将无法使用。
+
+**详细权限说明**: 查看 [PERMISSIONS.md](./PERMISSIONS.md)
+
+## License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,50 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:7.4.2"
+  }
+}
+
+apply plugin: "com.android.library"
+
+def isNewArchitectureEnabled() {
+  return project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
+}
+
+android {
+  compileSdkVersion 33
+
+  defaultConfig {
+    minSdkVersion 21
+    targetSdkVersion 33
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  sourceSets {
+    main {
+      if (isNewArchitectureEnabled()) {
+        java.srcDirs += ["src/newarch"]
+      } else {
+        java.srcDirs += ["src/oldarch"]
+      }
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+dependencies {
+  implementation "com.facebook.react:react-native:+"
+}

package/ios/DeviceInfoPlus.h

@@ -0,0 +1,15 @@
+#import <RCTTypeSafety/RCTConvertHelpers.h>
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#import "RNDeviceInfoPlusSpec.h"
+
+@interface DeviceInfoPlus : RCTEventEmitter <NativeDeviceInfoPlusSpec>
+#else
+#import <React/RCTBridgeModule.h>
+
+@interface DeviceInfoPlus : RCTEventEmitter <RCTBridgeModule>
+#endif
+
+@end