app_store_dev_api 0.1.9 → 0.3.1

data/docs/pindo_usage_reference.md

@@ -0,0 +1,234 @@
+# Pindo 项目中 app_store_dev_api 使用参考
+
+> 本文档记录 [pindo](../../pindo) CLI 工具如何使用 `app_store_dev_api` gem 进行 App Store Connect API 认证和调用，作为集成参考。
+
+## Gem 依赖
+
+```ruby
+# pindo.gemspec
+spec.add_runtime_dependency "app_store_dev_api", '~> 0.3.0'
+```
+
+## 认证流程
+
+Pindo 采用 **本地 JSON 文件 + 交互式输入** 的方式管理 API 密钥凭证。
+
+### 流程图
+
+```
+启动命令 (pindo appstore iap)
+       ↓
+从项目 config.json 读取 apple_id、bundle_id
+       ↓
+检查 {pindo_dir}/api_key.json 是否存在该 apple_id 的凭证
+       ↓
+  ┌─── 存在 ───┐          ┌─── 不存在 ───┐
+  │            │          │              │
+  │ 直接加载    │          │ 交互式输入     │
+  │ issuer_id  │          │ issuer_id    │
+  │ key_id     │          │ key_id       │
+  │ private_key│          │ .p8 文件路径   │
+  │            │          │              │
+  └─────┬──────┘          │ 读取 .p8 文件  │
+        │                 │ 用户确认       │
+        │                 │ 保存到 JSON    │
+        │                 └──────┬────────┘
+        │                        │
+        └────────┬───────────────┘
+                 ↓
+  AppStoreDevApi::Client.new(
+    issuer_id: issuer_id,
+    key_id: key_id,
+    private_key: private_key
+  )
+                 ↓
+         开始调用 API
+```
+
+### 核心代码
+
+**文件:** `pindo/lib/pindo/command/appstore/iap.rb`
+
+```ruby
+def login_api_key(apple_id: nil)
+  load_apikey_config = false
+  api_key_json = nil
+  pindo_dir = File.expand_path(pindo_single_config.pindo_dir)
+  api_key_file = File.join(pindo_dir, "api_key.json")
+
+  # 步骤1：尝试从本地配置文件加载
+  if File.exist?(api_key_file)
+    api_key_json = JSON.parse(File.read(api_key_file))
+    if !api_key_json.nil? && !api_key_json[apple_id].nil? && !api_key_json[apple_id]["issuer_id"].nil?
+      issuer_id = api_key_json[apple_id]["issuer_id"]
+      key_id = api_key_json[apple_id]["key_id"]
+      private_key = api_key_json[apple_id]["private_key"]
+      load_apikey_config = true
+    end
+  end
+
+  # 步骤2：如果未加载，交互式输入凭证
+  if !load_apikey_config
+    issuer_id = ask('请输入 issuer_id: ')
+    key_id = ask('请输入 key_id: ')
+    private_key_file = ask('请输入private key的文件路径: ')
+    private_key = File.read(File.new(private_key_file))
+
+    # 构建配置
+    api_key_json = api_key_json || {}
+    api_key_json[apple_id] = api_key_json[apple_id] || {}
+    api_key_json[apple_id]["issuer_id"] = issuer_id
+    api_key_json[apple_id]["key_id"] = key_id
+    api_key_json[apple_id]["private_key"] = private_key
+
+    # 步骤3：用户确认
+    answer = agree("请确认上面信息是否正确(Y/n）:")
+    unless answer
+      raise Informative, "重新输入 !!!"
+    end
+
+    # 步骤4：持久化到本地文件
+    File.open(api_key_file, "w") do |f|
+      f.write(JSON.pretty_generate(api_key_json))
+    end
+    load_apikey_config = true
+  end
+
+  # 步骤5：初始化 API 客户端
+  if load_apikey_config
+    @app_store_connect = AppStoreDevApi::Client.new(
+      issuer_id: issuer_id,
+      key_id: key_id,
+      private_key: private_key
+    )
+  end
+end
+```
+
+## 凭证存储格式
+
+### 存储路径
+
+```
+{pindo_dir}/api_key.json
+```
+
+`pindo_dir` 由 `pindo_single_config.pindo_dir` 确定，通常位于用户本地配置目录。
+
+### JSON 结构（支持多账户）
+
+```json
+{
+  "user1@example.com": {
+    "issuer_id": "57246542-96fe-1a63-e053-0824d011072a",
+    "key_id": "2X9R4HXF34",
+    "private_key": "-----BEGIN PRIVATE KEY-----\nMIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQg...\n-----END PRIVATE KEY-----"
+  },
+  "user2@example.com": {
+    "issuer_id": "69384721-abcd-efgh-ijkl-123456789012",
+    "key_id": "ABC123DEF4",
+    "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
+  }
+}
+```
+
+**关键设计:**
+- 以 Apple ID（邮箱）作为一级 key，支持多账户切换
+- `private_key` 直接存储 PEM 格式的私钥内容（非文件路径）
+- 首次输入时从 `.p8` 文件读取，之后直接使用存储的内容
+
+## API 调用示例
+
+### 初始化入口
+
+```ruby
+def run
+  # 从项目 config.json 加载 apple_id 和 bundle_id
+  config_file = File.join(project_dir, "config.json")
+  config_parser = Pindo::IosConfigParser.instance
+  config_parser.load_config(config_file: config_file)
+  @bundle_id = config_parser.bundle_id
+  @apple_id = config_parser.apple_id
+
+  # 登录并初始化客户端
+  login_api_key(apple_id: @apple_id)
+
+  # 开始使用 API...
+end
+```
+
+### 查询应用
+
+```ruby
+app_list_response = @app_store_connect.list_apps(
+  filter: { bundle_id: @bundle_id }
+)
+```
+
+### 获取内购项目
+
+```ruby
+# 消耗型内购
+get_consumable_iap_items(
+  appstore_client: @app_store_connect,
+  app_id: app_id,
+  in_app_purchase_type: "CONSUMABLE"
+)
+
+# 订阅组
+get_subscriptions_groups(
+  appstore_client: @app_store_connect,
+  app_id: app_id
+)
+```
+
+### 沙盒测试账户
+
+```ruby
+@app_store_connect.list_sandbox_testers()
+```
+
+## 其他集成点
+
+Pindo 中还有以下任务类支持 API Key 认证参数（通过 options 传递）：
+
+### 截图上传任务
+
+**文件:** `pindo/lib/pindo/module/task/model/appstore/appstore_upload_screenshot_task.rb`
+
+```ruby
+def initialize(app_id, screenshot_path, options = {})
+  @api_key_id    = options[:api_key_id]       # API Key ID
+  @api_issuer_id = options[:api_issuer_id]    # Issuer ID
+  @api_key_path  = options[:api_key_path]     # .p8 文件路径
+end
+```
+
+### 元数据上传任务
+
+**文件:** `pindo/lib/pindo/module/task/model/appstore/appstore_upload_metadata_task.rb`
+
+```ruby
+@api_key_id    = options[:api_key_id]
+@api_issuer_id = options[:api_issuer_id]
+@api_key_path  = options[:api_key_path]
+```
+
+> 注意：这些任务类使用的是 **文件路径** (`api_key_path`) 而非私钥内容，与 IAP 命令的处理方式略有不同。
+
+## 设计要点总结
+
+| 特性 | 说明 |
+|------|------|
+| 多账户支持 | 以 Apple ID 为 key 管理多套凭证 |
+| 本地持久化 | JSON 文件存储，首次输入后免重复 |
+| 交互式输入 | 首次使用通过命令行交互式收集凭证 |
+| 私钥存储方式 | 存储 PEM 内容而非文件路径 |
+| Client 初始化 | 三个参数: `issuer_id`, `key_id`, `private_key` |
+| Token 管理 | 由 `app_store_dev_api` gem 内部自动处理 JWT 生成 |
+
+## 相关文档
+
+- [创建 API 密钥](creating_api_keys.md)
+- [生成 API 请求 Token](generating_tokens.md)
+- [撤销 API 密钥](revoking_api_keys.md)

data/docs/revoking_api_keys.md

@@ -0,0 +1,118 @@
+# 撤销 API 密钥
+
+> 官方文档: https://developer.apple.com/documentation/appstoreconnectapi/revoking-api-keys
+
+## 概述
+
+当 API 密钥不再需要、可能泄露、或需要轮换时，应及时撤销。撤销后的密钥将永久失效，使用该密钥生成的所有 JWT Token 也将立即失效。
+
+## 撤销步骤
+
+### 撤销团队密钥
+
+1. 登录 [App Store Connect](https://appstoreconnect.apple.com/)
+2. 导航到 **用户和访问 (Users and Access)**
+3. 选择 **集成 (Integrations)** 选项卡
+4. 在左侧导航中选择 **App Store Connect API**
+5. 选择 **团队密钥 (Team Keys)** 标签页
+6. 找到要撤销的密钥
+7. 点击密钥名称旁的 **撤销 (Revoke)** 按钮
+8. 在确认对话框中确认撤销
+
+### 撤销个人密钥
+
+1. 登录 [App Store Connect](https://appstoreconnect.apple.com/)
+2. 导航到 **用户和访问 (Users and Access)**
+3. 选择 **集成 (Integrations)** 选项卡
+4. 选择 **个人密钥 (Individual Keys)** 标签页
+5. 找到要撤销的密钥并点击 **撤销 (Revoke)**
+
+## 撤销后的影响
+
+### 立即生效
+
+- 密钥状态变为 **已撤销 (Revoked)**
+- 使用该密钥签名的所有 JWT Token 立即失效
+- 所有使用该 Token 的 API 请求将返回 `401 NOT_AUTHORIZED`
+
+### 不可逆操作
+
+> ⚠️ **警告**: 密钥撤销是**永久性**操作，无法恢复。一旦撤销，该密钥将无法重新激活。
+
+- 已撤销的密钥仍会显示在密钥列表中（标记为已撤销），但无法使用
+- 私钥文件（`.p8`）即使仍存在也无法再用于生成有效 Token
+- Key ID 不会被回收利用
+
+### 对正在运行的服务的影响
+
+- 所有依赖该密钥的 CI/CD 流水线将立即中断
+- 所有使用该密钥的自动化脚本将失败
+- 所有后端服务的 API 调用将返回认证错误
+
+## 何时应该撤销密钥
+
+| 场景 | 紧急程度 | 建议操作 |
+|------|----------|----------|
+| 私钥文件泄露（提交到公开仓库等） | 🔴 立即 | 立刻撤销，创建新密钥 |
+| 团队成员离职 | 🟡 尽快 | 撤销其创建的密钥 |
+| 密钥定期轮换 | 🟢 计划中 | 先创建新密钥，迁移后再撤销旧密钥 |
+| 密钥权限过高 | 🟡 尽快 | 创建权限适当的新密钥后撤销 |
+| 密钥不再使用 | 🟢 常规 | 确认无依赖后撤销 |
+
+## 安全的密钥轮换流程
+
+为避免服务中断，建议按以下步骤进行密钥轮换：
+
+```
+1. 创建新密钥
+       ↓
+2. 下载新私钥文件 (.p8)
+       ↓
+3. 更新所有服务/脚本使用新密钥
+       ↓
+4. 验证所有服务正常运行
+       ↓
+5. 撤销旧密钥
+       ↓
+6. 删除旧私钥文件
+```
+
+### 在本项目中轮换密钥
+
+```ruby
+# 1. 使用新密钥创建客户端
+new_client = AppStoreDevApi::Client.new(
+  issuer_id: ENV['APP_STORE_CONNECT_ISSUER_ID'],  # Issuer ID 不变
+  key_id: 'NEW_KEY_ID',
+  private_key: File.read('/path/to/new_AuthKey.p8')
+)
+
+# 2. 验证新密钥可用
+apps = new_client.list_apps
+puts "新密钥验证成功，共 #{apps['data'].size} 个应用"
+
+# 3. 确认后，在 App Store Connect 中撤销旧密钥
+```
+
+## 常见问题
+
+### 撤销密钥后可以恢复吗？
+
+不可以。密钥撤销是永久性操作。如果误操作，只能创建新密钥。
+
+### 撤销密钥会影响应用吗？
+
+不会。撤销 API 密钥只影响 API 访问能力，不会影响已发布的应用、用户数据或 App Store 上架状态。
+
+### 一个团队最多可以有多少个活跃密钥？
+
+Apple 对每个团队的活跃 API 密钥数量有限制。建议只保留实际使用的密钥，及时撤销不再需要的密钥。
+
+### 撤销后 Issuer ID 会变吗？
+
+不会。Issuer ID 是团队级别的标识，不受单个密钥撤销的影响。
+
+## 相关文档
+
+- [创建 API 密钥](creating_api_keys.md)
+- [生成 API 请求 Token](generating_tokens.md)

data/install_local.bat

@@ -0,0 +1,166 @@
+@echo off
+rem Windows批处理脚本，用于快速构建和安装当前Ruby gem到本机测试
+chcp 65001 >nul 2>&1
+
+setlocal enabledelayedexpansion
+
+
+rem 获取当前脚本目录
+set "CURRENT_DIR=%~dp0"
+set "CURRENT_DIR=%CURRENT_DIR:~0,-1%"
+echo [LOG] Step 1: Get current directory
+echo 当前目录: %CURRENT_DIR%
+
+rem 自动检测当前项目名称
+echo [LOG] Step 2: Detect project name
+set "PROJECT_NAME="
+for %%i in ("%CURRENT_DIR%\*.gemspec") do (
+    if exist "%%i" (
+        set "GEMSPEC_FILE=%%i"
+        for /f %%j in ("%%i") do set "PROJECT_NAME=%%~nj"
+        goto :found_gemspec
+    )
+)
+
+echo [LOG] 错误: 未找到gemspec文件!
+exit /b 1
+
+:found_gemspec
+echo [LOG] Step 3: Found project
+echo 检测到项目: %PROJECT_NAME%
+
+rem 清理旧的gem文件
+echo [LOG] Step 4: Clean old gem files
+if exist "%CURRENT_DIR%\%PROJECT_NAME%-*.gem" (
+    echo 清理旧的gem文件...
+    del /q "%CURRENT_DIR%\%PROJECT_NAME%-*.gem"
+)
+
+rem 自动检测版本文件
+echo [LOG] Step 5: Detect version file
+set "VERSION_FILE="
+for /r "%CURRENT_DIR%\lib" %%i in (version.rb) do (
+    if exist "%%i" (
+        set "VERSION_FILE=%%i"
+        goto :found_version
+    )
+)
+
+echo [LOG] 错误: 未找到version.rb文件!
+exit /b 1
+
+:found_version
+echo [LOG] Step 6: Found version file
+echo 检测到版本文件: %VERSION_FILE%
+
+rem 从version.rb文件提取版本号
+echo [LOG] Step 7: Extract version number
+set "VERSION_TAG_NAME="
+for /f "tokens=*" %%i in ('findstr /r "VERSION.*=" "%VERSION_FILE%"') do (
+    set "line=%%i"
+    rem 提取引号中的版本号
+    for /f "tokens=2 delims='" %%j in ("!line!") do set "VERSION_TAG_NAME=%%j"
+    if "!VERSION_TAG_NAME!"=="" (
+        for /f "tokens=2 delims=""" %%j in ("!line!") do set "VERSION_TAG_NAME=%%j"
+    )
+)
+
+if "%VERSION_TAG_NAME%"=="" (
+    echo [LOG] 错误: 无法从版本文件中解析版本号
+    echo 版本文件内容:
+    type "%VERSION_FILE%"
+    exit /b 1
+)
+
+echo [LOG] Step 8: Version number parsed successfully
+echo 检测到版本: %VERSION_TAG_NAME%
+
+rem 验证版本号格式 (基本检查是否包含点号)
+echo %VERSION_TAG_NAME% | findstr "." >nul
+if errorlevel 1 (
+    echo 警告: 版本号格式可能不正确: %VERSION_TAG_NAME%
+)
+
+rem 构建gem
+echo [LOG] Step 9: Start building gem
+echo 构建 %PROJECT_NAME% gem...
+cd /d "%CURRENT_DIR%"
+
+rem 构建gem，忽略警告的退出码
+echo [LOG] Step 10: Execute gem build command
+gem build "%GEMSPEC_FILE%"
+rem 重置错误级别，防止警告阻止脚本继续
+cd .
+echo [LOG] Step 11: gem build command completed, checking result
+echo [DEBUG] Looking for file: %PROJECT_NAME%-%VERSION_TAG_NAME%.gem
+
+rem 检查是否生成了gem文件来判断构建是否成功
+if not exist "%PROJECT_NAME%-%VERSION_TAG_NAME%.gem" (
+    echo [LOG] 错误: gem构建失败，未找到生成的gem文件!
+    echo [DEBUG] 当前目录文件列表:
+    dir *.gem
+    exit /b 1
+) else (
+    echo [LOG] Step 12: gem build success confirmed
+    echo ✓ gem构建成功
+    echo.
+    echo ==========================================
+    echo 构建完成！现在可以安装到本地：
+    echo.
+    echo 安装命令：
+    echo   gem install --local --force %PROJECT_NAME%-%VERSION_TAG_NAME%.gem
+    echo.
+    echo 安装后验证：
+    echo   %PROJECT_NAME% --version
+    echo   %PROJECT_NAME% --help
+    echo ==========================================
+    echo.
+)
+
+rem 查找生成的gem文件
+echo [LOG] Step 13: Search for generated gem file
+set "GEM_FILE="
+if exist "%PROJECT_NAME%-%VERSION_TAG_NAME%.gem" (
+    set "GEM_FILE=%PROJECT_NAME%-%VERSION_TAG_NAME%.gem"
+) else (
+    rem 尝试查找任何版本的gem文件
+    for %%i in ("%PROJECT_NAME%-*.gem") do (
+        set "GEM_FILE=%%i"
+        goto :found_gem
+    )
+)
+
+:found_gem
+if "%GEM_FILE%"=="" (
+    echo [LOG] 错误: 未找到生成的gem文件!
+    exit /b 1
+)
+
+echo [LOG] Step 14: Found gem file
+echo 找到gem文件: %GEM_FILE%
+echo [LOG] Step 15: Start installing gem
+echo 安装 %GEM_FILE%...
+
+rem 安装gem（使用force参数忽略依赖检查）
+echo [LOG] Step 16: Execute gem install command
+gem install --local --force "%GEM_FILE%"
+echo [LOG] Step 17: gem install command completed
+
+if errorlevel 1 (
+    echo [LOG] 错误: gem安装失败!
+    echo 尝试手动安装: gem install --local --force "%GEM_FILE%"
+    exit /b 1
+) else (
+    echo [LOG] Step 18: gem installation successful
+    echo ✓ %PROJECT_NAME% 安装成功!
+    echo [LOG] Step 19: Verify installed version
+    echo 当前版本:
+    %PROJECT_NAME% --version
+    echo.
+    echo 可以使用以下命令测试:
+    echo   %PROJECT_NAME% --help
+    echo   %PROJECT_NAME% --version
+    echo [LOG] Step 20: Script execution completed
+)
+
+pause

data/install_local.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+
+#当前脚本目录 (macOS兼容)
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  CURRENT_DIR=$(dirname $(greadlink -f $0 2>/dev/null || readlink $0 2>/dev/null || echo $0))
+else
+  CURRENT_DIR=$(dirname $(readlink -f $0))
+fi
+CURRENT_DIR=$(cd "$CURRENT_DIR" && pwd)
+echo $CURRENT_DIR
+
+
+# Make all files and directories in the current directory readable, writable, and executable for all users.
+/bin/chmod -R a+rwx $CURRENT_DIR
+# Change the owner of the current directory to the current user.
+/usr/sbin/chown $(whoami) $CURRENT_DIR
+# Change the group of the current directory to "admin".
+/usr/bin/chgrp admin $CURRENT_DIR
+
+function readConfigValue()
+{
+  File=$1
+  KEY=$2
+  VALUE=$(grep -m 1 -o "^[ ]*$KEY[ ]*=[ ]*[\"]*.*[\"]*" $File | sed -e "s/^[ ]*$KEY[ ]*=[ ]*[\"]*//" -e "s/[\"]*$//")
+  echo $VALUE
+}
+
+
+# 自动检测当前项目名称
+GEMSPEC_FILE=$(find $CURRENT_DIR -maxdepth 1 -name "*.gemspec" | head -n 1)
+if [ -z "$GEMSPEC_FILE" ]; then
+  echo "错误: 未找到gemspec文件!"
+  exit 1
+fi
+
+# 从gemspec文件名获取项目名称
+PROJECT_NAME=$(basename $GEMSPEC_FILE .gemspec)
+echo "检测到项目: $PROJECT_NAME"
+
+# 清理旧的gem文件
+rm -rf $CURRENT_DIR/*${PROJECT_NAME}-*.gem
+
+# 自动检测版本文件
+VERSION_FILE=$(find $CURRENT_DIR/lib -name "version.rb" | head -n 1)
+if [ -z "$VERSION_FILE" ]; then
+  echo "错误: 未找到version.rb文件!"
+  exit 1
+fi
+
+echo "检测到版本文件: $VERSION_FILE"
+VERSION_KEY="VERSION"
+# 改进版本号提取方式，确保只获取版本号部分
+VERSION_TAG_NAME=$(grep -o "${VERSION_KEY}.*=.*['\"]\(.*\)['\"]" ${VERSION_FILE} | head -1 | sed -E "s/.*['\"]([0-9]+\.[0-9]+\.[0-9]+)['\"].*/\1/")
+echo "检测到版本: $VERSION_TAG_NAME"
+
+# 验证版本号格式
+if [[ ! $VERSION_TAG_NAME =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo "错误: 无法正确解析版本号，获取到的值: '$VERSION_TAG_NAME'"
+  echo "直接查看版本文件内容:"
+  cat $VERSION_FILE
+  exit 1
+fi
+
+
+# 构建和安装gem
+echo "构建 $PROJECT_NAME gem..."
+gem build $GEMSPEC_FILE
+
+# 查找生成的gem文件（在当前目录和CURRENT_DIR中查找）
+GEM_FILE=$(find . -maxdepth 1 -name "${PROJECT_NAME}-${VERSION_TAG_NAME}.gem" | head -n 1)
+if [ -z "$GEM_FILE" ]; then
+  GEM_FILE=$(find $CURRENT_DIR -maxdepth 1 -name "${PROJECT_NAME}-${VERSION_TAG_NAME}.gem" | head -n 1)
+fi
+
+if [ -n "$GEM_FILE" ]; then
+  echo "找到gem文件: $GEM_FILE"
+  echo "安装 $PROJECT_NAME-${VERSION_TAG_NAME}.gem..."
+  gem install --local "$GEM_FILE"
+else
+  echo "错误: 未找到生成的gem文件! 尝试查找任何版本的gem..."
+  ANY_GEM=$(find . -maxdepth 1 -name "${PROJECT_NAME}-*.gem" | head -n 1)
+  if [ -n "$ANY_GEM" ]; then
+    echo "找到gem文件: $ANY_GEM"
+    echo "安装 $ANY_GEM..."
+    gem install --local "$ANY_GEM"
+  else
+    echo "未找到任何${PROJECT_NAME}的gem文件"
+  fi
+fi
+
+
+
+
+
+

data/install_local_fixed.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+# 简化的本地安装脚本 - 适用于库 gem 项目
+
+set -e  # 遇到错误立即退出
+
+# 获取当前目录
+CURRENT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$CURRENT_DIR"
+
+echo "=========================================="
+echo "本地构建和安装 Gem"
+echo "=========================================="
+echo
+
+# 1. 自动检测项目名称
+GEMSPEC_FILE=$(find . -maxdepth 1 -name "*.gemspec" | head -n 1)
+if [ -z "$GEMSPEC_FILE" ]; then
+  echo "❌ 错误: 未找到 .gemspec 文件"
+  exit 1
+fi
+
+PROJECT_NAME=$(basename "$GEMSPEC_FILE" .gemspec)
+echo "项目: $PROJECT_NAME"
+
+# 2. 自动检测版本号
+VERSION_FILE=$(find ./lib -name "version.rb" | head -n 1)
+if [ -z "$VERSION_FILE" ]; then
+  echo "❌ 错误: 未找到 version.rb 文件"
+  exit 1
+fi
+
+# 提取版本号
+VERSION=$(grep -o "VERSION.*=.*['\"][0-9.]*['\"]" "$VERSION_FILE" | sed -E "s/.*['\"]([0-9.]+)['\"].*/\1/")
+
+if [ -z "$VERSION" ]; then
+  echo "❌ 错误: 无法解析版本号"
+  cat "$VERSION_FILE"
+  exit 1
+fi
+
+echo "版本: $VERSION"
+echo
+
+# 3. 清理旧的 gem 文件
+echo "清理旧的 gem 文件..."
+rm -f *.gem
+echo "✓ 清理完成"
+echo
+
+# 4. 构建 gem
+echo "构建 gem..."
+gem build "$GEMSPEC_FILE"
+
+GEM_FILE="${PROJECT_NAME}-${VERSION}.gem"
+
+if [ ! -f "$GEM_FILE" ]; then
+  echo "❌ 错误: gem 构建失败，未找到 $GEM_FILE"
+  exit 1
+fi
+
+echo "✓ 构建成功: $GEM_FILE"
+echo
+
+# 5. 安装到本地
+echo "安装到本地..."
+gem install "$GEM_FILE"
+
+echo
+echo "=========================================="
+echo "✅ 安装成功！"
+echo "=========================================="
+echo
+echo "使用方法 (Ruby 代码中):"
+echo "  require 'app_store_dev_api'"
+echo "  client = AppStoreDevApi::Client.new("
+echo "    key_id: 'YOUR_KEY_ID',"
+echo "    issuer_id: 'YOUR_ISSUER_ID',"
+echo "    private_key: File.read('AuthKey.p8')"
+echo "  )"
+echo
+echo "验证安装:"
+echo "  gem list | grep $PROJECT_NAME"
+echo "  ruby -r app_store_dev_api -e 'puts AppStoreDevApi::VERSION'"
+echo "=========================================="