expo-gaode-map 0.1.0

package/.eslintrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  root: true,
+  extends: ['universe/native', 'universe/web'],
+  ignorePatterns: ['build'],
+};

package/PUBLISHING.md

@@ -0,0 +1,244 @@
+# 发布到 NPM 指南
+
+本文档说明如何将 `expo-smartrefreshlayout` 发布到 npm。
+
+## 📋 发布前检查清单
+
+在发布之前，请确保：
+
+- [x] README.md 文档完整且准确
+- [x] package.json 配置正确
+- [x] 所有代码已提交到 Git
+- [ ] 构建成功无错误
+- [ ] 版本号已更新
+- [ ] 已有 npm 账号并已登录
+
+## 🚀 发布步骤
+
+### 1. 注册/登录 npm 账号
+
+如果你还没有 npm 账号，需要先注册：
+
+```bash
+# 注册账号（如果还没有）
+npm adduser
+
+# 或者登录已有账号
+npm login
+```
+
+按照提示输入：
+- Username（用户名）
+- Password（密码）
+- Email（邮箱）
+- OTP（如果启用了双因素认证）
+
+验证是否登录成功：
+```bash
+npm whoami
+```
+
+### 2. 检查 .npmignore 文件
+
+确保 `.npmignore` 文件配置正确，避免发布不必要的文件。当前项目已配置。
+
+### 3. 清理并构建项目
+
+```bash
+# 清理之前的构建
+npm run clean
+
+# 重新构建
+npm run build
+```
+
+构建完成后，会在 `build/` 目录生成编译后的文件。
+
+### 4. 测试构建结果
+
+在发布前，建议先测试构建结果：
+
+```bash
+# 查看会被发布的文件列表
+npm pack --dry-run
+
+# 或者创建一个本地 tarball 测试
+npm pack
+```
+
+这会显示将要发布到 npm 的所有文件。
+
+### 5. 更新版本号
+
+使用 npm version 命令更新版本号（这会自动创建 git tag）：
+
+```bash
+# 修复版本（0.1.0 -> 0.1.1）
+npm version patch
+
+# 次要版本（0.1.0 -> 0.2.0）
+npm version minor
+
+# 主要版本（0.1.0 -> 1.0.0）
+npm version major
+```
+
+或者手动修改 `package.json` 中的 `version` 字段。
+
+### 6. 发布到 npm
+
+```bash
+# 正式发布
+npm publish
+
+# 如果是第一次发布公开包，需要添加 --access public
+npm publish --access public
+```
+
+**注意**：
+- 首次发布必须使用 `--access public`，因为默认是私有包
+- 发布后无法撤销，只能发布新版本
+- 包名不能与已存在的包重复
+
+### 7. 验证发布
+
+发布成功后，可以：
+
+1. 访问 npm 页面查看：
+   ```
+   https://www.npmjs.com/package/expo-smartrefreshlayout
+   ```
+
+2. 尝试安装测试：
+   ```bash
+   # 在另一个项目中测试安装
+   npm install expo-smartrefreshlayout
+   ```
+
+3. 查看包信息：
+   ```bash
+   npm info expo-smartrefreshlayout
+   ```
+
+### 8. 提交代码到 Git
+
+```bash
+# 添加所有更改
+git add .
+
+# 提交更改
+git commit -m "chore: publish version 0.1.0"
+
+# 推送到远程仓库（包括 tags）
+git push origin main --tags
+```
+
+## 🔄 发布新版本
+
+当需要发布新版本时：
+
+1. 修改代码并测试
+2. 更新 README.md（如果有 API 变化）
+3. 运行 `npm run build` 重新构建
+4. 更新版本号：`npm version patch/minor/major`
+5. 发布：`npm publish`
+6. 推送到 Git：`git push origin main --tags`
+
+## 📝 版本号规范（语义化版本）
+
+版本号格式：`主版本号.次版本号.修订号`（例如：1.2.3）
+
+- **主版本号（Major）**：不兼容的 API 修改
+- **次版本号（Minor）**：向下兼容的功能性新增
+- **修订号（Patch）**：向下兼容的问题修正
+
+例如：
+- `0.1.0` -> `0.1.1`：修复 bug
+- `0.1.0` -> `0.2.0`：添加新功能
+- `0.1.0` -> `1.0.0`：重大更新，可能不兼容旧版本
+
+## ⚠️ 常见问题
+
+### 1. 包名已存在
+
+如果提示包名已被占用，需要修改 `package.json` 中的 `name` 字段：
+
+```json
+{
+  "name": "@your-username/expo-smartrefreshlayout"
+}
+```
+
+使用 npm scope 可以避免命名冲突。
+
+### 2. 需要双因素认证（2FA）
+
+如果账号启用了 2FA，发布时需要提供 OTP：
+
+```bash
+npm publish --otp=123456
+```
+
+### 3. 构建失败
+
+确保安装了所有依赖：
+
+```bash
+npm install
+npm run build
+```
+
+### 4. 发布权限问题
+
+确保你已登录正确的 npm 账号：
+
+```bash
+npm whoami
+npm login
+```
+
+## 🎯 发布检查脚本
+
+你可以创建一个脚本来自动化发布前检查：
+
+```bash
+#!/bin/bash
+
+echo "🔍 检查 Git 状态..."
+if [[ -n $(git status -s) ]]; then
+    echo "❌ 有未提交的更改，请先提交"
+    exit 1
+fi
+
+echo "🧹 清理构建..."
+npm run clean
+
+echo "🔨 开始构建..."
+npm run build
+
+echo "✅ 构建成功！"
+echo "📦 预览将要发布的文件："
+npm pack --dry-run
+
+echo ""
+echo "准备发布！请运行："
+echo "  npm version patch  # 或 minor/major"
+echo "  npm publish --access public"
+```
+
+## 📚 相关资源
+
+- [npm 官方文档](https://docs.npmjs.com/)
+- [语义化版本规范](https://semver.org/lang/zh-CN/)
+- [Expo Modules 文档](https://docs.expo.dev/modules/overview/)
+
+## 🎉 首次发布
+
+如果这是首次发布，建议：
+
+1. 先发布 `0.1.0` 版本进行测试
+2. 收集用户反馈
+3. 修复问题后发布 `0.1.1`、`0.1.2` 等
+4. 功能稳定后发布 `1.0.0` 正式版
+
+祝发布顺利！🚀