app_store_dev_api 0.1.9 → 0.3.0

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,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 "=========================================="

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 "=========================================="

data/lib/app_store_dev_api/client/authorization.rb

@@ -19,15 +19,20 @@ module AppStoreDevApi
       end
 
       def payload
+        current_time = Time.now.to_i
         {
-          exp: Time.now.to_i + 20 * 60,
           iss: issuer_id,
+          iat: current_time,
+          exp: current_time + 20 * 60,
           aud: AUDIENCE
         }
       end
 
       def header_fields
-        { kid: key_id }
+        {
+          kid: key_id,
+          typ: 'JWT'
+        }
       end
 
       def token

data/lib/app_store_dev_api/client/builder.rb

@@ -1,5 +1,26 @@
 # frozen_string_literal: true
 
+require 'json'
+require 'active_support/core_ext/hash'
+
+# ⚠️  注意：此 Builder 类已不再使用
+#
+# Client 现在完全使用动态方法调度（method_missing），无需预生成方法。
+#
+# 此 Builder 类保留用于以下可选场景：
+# 1. IDE 自动补全支持 - 生成方法定义供 IDE 解析
+# 2. 类型检查工具 - 生成方法签名供 Sorbet/Steep 使用
+# 3. 文档生成 - 生成完整的方法列表文档
+#
+# 默认情况下不使用，Client 直接继承 Base 使用动态调度。
+#
+# 如需生成（可选）：
+#   ruby -r ./lib/app_store_dev_api/client/builder.rb \
+#     -e "AppStoreDevApi::Client::Builder.new.write"
+#
+# 生成后的文件：
+#   lib/app_store_dev_api/client_generated.rb (不会覆盖 client.rb)
+#
 module AppStoreDevApi
   class Client
     class Builder
@@ -11,6 +32,7 @@ module AppStoreDevApi
         # This file is generated.
         #
         # WARNING ABOUT GENERATED CODE
+        #
 
         module AppStoreDevApi
           class Client < Base
@@ -33,46 +55,23 @@ module AppStoreDevApi
       private_constant :TEMPLATE
 
       def web_service_endpoints
-        [
-          {
-            "alias": 'create_certificate',
-            "http_method": 'post',
-            "url": 'https://api.appstoreconnect.apple.com/v1/certificates',
-            "http_body_type": 'Requests::V1::Certificate::Create',
-            "see": 'https://developer.apple.com/documentation/appstoreconnectapi'
-          },
-          {
-            "http_method": 'delete',
-            "url": 'https://api.appstoreconnect.apple.com/v1/users/{id}/relationships/visibleApps',
-            "alias": 'delete_visible_app',
-            "see": 'https://developer.apple.com/documentation/appstoreconnectapi'
-          },
-          {
-            "alias": 'create_bundle_id',
-            "url": 'https://api.appstoreconnect.apple.com/v1/bundleIds',
-            "http_body_type": 'Requests::V1::BundleId::Create',
-            "http_method": 'post',
-            "see": 'https://developer.apple.com/documentation/appstoreconnectapi/register_a_new_bundle_id'
-          },
-          {
-            "alias": 'create_bundle_id_capability',
-            "url": 'https://api.appstoreconnect.apple.com/v1/bundleIdCapabilities',
-            "http_body_type": 'Requests::V1::BundleIdCapability::Create',
-            "http_method": 'post',
-            "see": 'https://developer.apple.com/documentation/appstoreconnectapi'
-          },
-          {
-            "alias": 'create_beta_build_localization',
-            "url": 'https://api.appstoreconnect.apple.com/v1/betaBuildLocalizations',
-            "http_body_type": 'Requests::V1::BetaBuildLocalization::Create',
-            "http_method": 'post',
-            "see": 'https://developer.apple.com/documentation/appstoreconnectapi'
-          }
-        ].map(&:symbolize_keys)
+        @web_service_endpoints ||= begin
+          schema_content = File.read(schema_path)
+          schema = JSON.parse(schema_content)
+          
+          schema['web_service_endpoints'].map do |endpoint|
+            endpoint.symbolize_keys.tap do |ep|
+              ep[:see] ||= 'https://developer.apple.com/documentation/appstoreconnectapi'
+            end
+          end
+        end
       end
 
-      def write
-        File.write('lib/app_store_dev_api/client.rb', source)
+      def write(output_file = 'lib/app_store_dev_api/client_generated.rb')
+        File.write(output_file, source)
+        puts "✅ 已生成方法定义到: #{output_file}"
+        puts "⚠️  注意: 这是可选的生成文件，仅用于 IDE 支持"
+        puts "   默认使用动态调度，无需此文件"
       end
 
       def source
@@ -86,6 +85,12 @@ module AppStoreDevApi
 
         @source
       end
+
+      private
+
+      def schema_path
+        File.join(Dir.pwd, 'lib/config/schema_v4.2.json')
+      end
     end
   end
 end

data/lib/app_store_dev_api/client/options.rb

@@ -9,7 +9,7 @@ module AppStoreDevApi
 
       DEFAULTS = {
         analytics_enabled: true,
-        schema: Schema.new(File.join(__dir__, '..', '..', 'config', 'schema.json'))
+        schema: Schema.new(File.join(__dir__, '..', '..', 'config', 'schema_v4.2.json'))
       }.freeze
       private_constant :DEFAULTS
 

data/lib/app_store_dev_api/client.rb

@@ -1,66 +1,37 @@
 # frozen_string_literal: true
 
-# WARNING ABOUT GENERATED CODE
-#
-# This file is generated.
-#
-# WARNING ABOUT GENERATED CODE
-
 module AppStoreDevApi
+  # Client 使用 Base 的 method_missing 机制动态调度所有 API 方法
+  # 所有端点配置从 schema.json 加载
+  #
+  # 用法:
+  #   client = AppStoreDevApi::Client.new(
+  #     issuer_id: 'your_issuer_id',
+  #     key_id: 'your_key_id',
+  #     private_key: private_key_pem
+  #   )
+  #
+  # 所有 API 方法都可用（共 1,210 个方法）:
+  #   client.list_apps
+  #   client.create_bundle_id(...)
+  #   client.delete_user(id: 'user_id')
+  #   client.app_info(id: 'app_id')
+  #
+  # 查看所有可用方法:
+  #   client.web_service_endpoint_aliases
+  #   # => [:create_accessibility_declaration, :list_apps, ...]
+  #
+  # 检查方法是否存在:
+  #   client.respond_to?(:list_apps)  # => true
+  #
+  # 方法总数:
+  #   client.web_service_endpoint_aliases.size  # => 1210
+  #
+  # API 文档:
+  #   https://developer.apple.com/documentation/appstoreconnectapi
+  #
   class Client < Base
-    #
-    # @see https://developer.apple.com/documentation/appstoreconnectapi
-    #
-    def create_certificate(**kwargs)
-      web_service_endpoint = Schema::WebServiceEndpoint.new(
-        { http_body_type: 'Requests::V1::Certificate::Create', http_method: 'post', url: 'https://api.appstoreconnect.apple.com/v1/certificates' }
-      )
-
-      call(web_service_endpoint, **kwargs)
-    end
-
-    #
-    # @see https://developer.apple.com/documentation/appstoreconnectapi
-    #
-    def delete_visible_app(**kwargs)
-      web_service_endpoint = Schema::WebServiceEndpoint.new(
-        { http_method: 'delete', url: 'https://api.appstoreconnect.apple.com/v1/users/{id}/relationships/visibleApps' }
-      )
-
-      call(web_service_endpoint, **kwargs)
-    end
-
-    #
-    # @see https://developer.apple.com/documentation/appstoreconnectapi/register_a_new_bundle_id
-    #
-    def create_bundle_id(**kwargs)
-      web_service_endpoint = Schema::WebServiceEndpoint.new(
-        { http_body_type: 'Requests::V1::BundleId::Create', http_method: 'post', url: 'https://api.appstoreconnect.apple.com/v1/bundleIds' }
-      )
-
-      call(web_service_endpoint, **kwargs)
-    end
-
-    #
-    # @see https://developer.apple.com/documentation/appstoreconnectapi
-    #
-    def create_bundle_id_capability(**kwargs)
-      web_service_endpoint = Schema::WebServiceEndpoint.new(
-        { http_body_type: 'Requests::V1::BundleIdCapability::Create', http_method: 'post', url: 'https://api.appstoreconnect.apple.com/v1/bundleIdCapabilities' }
-      )
-
-      call(web_service_endpoint, **kwargs)
-    end
-
-    #
-    # @see https://developer.apple.com/documentation/appstoreconnectapi
-    #
-    def create_beta_build_localization(**kwargs)
-      web_service_endpoint = Schema::WebServiceEndpoint.new(
-        { http_body_type: 'Requests::V1::BetaBuildLocalization::Create', http_method: 'post', url: 'https://api.appstoreconnect.apple.com/v1/betaBuildLocalizations' }
-      )
-
-      call(web_service_endpoint, **kwargs)
-    end
+    # 所有方法通过 Base#method_missing 动态调度
+    # 端点配置从 lib/config/schema_v4.2.json 加载
   end
 end

data/lib/app_store_dev_api/object/attributes.rb

@@ -21,7 +21,7 @@ module AppStoreDevApi
 
           attributes.send(:define_method, :initialize) do |**kwargs|
             self.class.properties.each do |name, options|
-              raise ArgumentError, "#{name} required" if options[:required] && !kwargs[name]
+              raise ArgumentError, "#{name} required" if options[:required] && !kwargs.key?(name)
 
               value = kwargs.fetch(name, options[:default])
 

data/lib/app_store_dev_api/object/data.rb

@@ -13,19 +13,23 @@ module AppStoreDevApi
         klass = Class.new do |data|
           include Object::DataType
           include Object::Attributes
+          include Object::Relationships
           include Object::Type
           include Object::Id
 
           data.send(:define_method, :initialize) do |**kwargs|
-            instance_variable_set('@relationships', kwargs.delete(:relationships).to_h)
+            # 提取 relationships 参数
+            relationships_data = kwargs.delete(:relationships) || {}
+
             instance_variable_set('@data', Array(kwargs.delete(:data)))
             instance_variable_set('@attributes', data::Attributes.new(**kwargs))
+            instance_variable_set('@relationships', data::Relationships.new(**relationships_data))
             instance_variable_set('@id', kwargs[id_arg_name])
           end
 
           def to_h
             props = {
-              relationships: @relationships,
+              relationships: relationships.to_h,
               attributes: attributes.to_h,
               type: type
             }

data/lib/app_store_dev_api/object/relationships.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'active_support/concern'
+
+module AppStoreDevApi
+  module Object
+    module Relationships
+      extend ActiveSupport::Concern
+
+      class_methods do
+        def relationships(&block)
+          self::Relationships.class_eval(&block)
+        end
+      end
+
+      included do
+        attr_reader :relationships
+
+        klass = Class.new do |relationships|
+          include Object::Properties
+
+          relationships.send(:define_method, :initialize) do |**kwargs|
+            self.class.properties.each do |name, options|
+              raise ArgumentError, "#{name} required" if options[:required] && !kwargs.key?(name)
+
+              value = kwargs.fetch(name, options[:default])
+
+              instance_variable_set("@#{name}", value)
+            end
+          end
+
+          def to_h
+            {}.tap do |hash|
+              self.class.properties.each_key do |name|
+                value = instance_variable_get("@#{name}")
+
+                hash[name] = value unless value.nil?
+              end
+            end
+          end
+        end
+
+        const_set('Relationships', klass)
+      end
+    end
+  end
+end

data/lib/app_store_dev_api/requests/v1/accessibility_declaration/create.rb

@@ -0,0 +1,28 @@
+module AppStoreDevApi
+  module Requests
+    module V1
+      module AccessibilityDeclaration
+        class Create < Request::Body
+          data do
+            type 'accessibilityDeclarations'
+            attributes do
+              property :deviceFamily, required: true
+              property :supportsAudioDescriptions
+              property :supportsCaptions
+              property :supportsDarkInterface
+              property :supportsDifferentiateWithoutColorAlone
+              property :supportsLargerText
+              property :supportsReducedMotion
+              property :supportsSufficientContrast
+              property :supportsVoiceControl
+              property :supportsVoiceover
+            end
+            relationships do
+              property :app, required: true
+            end
+          end
+        end
+      end
+    end
+  end
+end