iOS应用归档 - 元素码农

发布时间: 2025-03-23 08:34

↑

# iOS应用归档

本文将详细介绍如何为React Native应用进行iOS打包和发布。通过本文,你将学会如何配置证书、打包应用、上传到App Store,以及发布应用的完整流程。

## 准备工作

### 1. 开发者账号

在开始之前,你需要:

- 注册Apple开发者账号
- 加入Apple Developer Program
- 获取相应的开发和发布权限

### 2. 证书配置

#### 开发证书

1. 打开Keychain Access
2. 选择Certificate Assistant → Request a Certificate From a Certificate Authority
3. 填写开发者邮箱和名称
4. 保存证书请求文件(CSR)

#### 发布证书

1. 访问[Apple Developer Center](https://developer.apple.com/account)
2. 创建Production证书
3. 下载并安装证书

### 3. Provisioning Profile

1. 创建App ID
   - 访问Certificates, Identifiers & Profiles
   - 选择Identifiers → App IDs
   - 创建新的App ID

2. 配置Provisioning Profile
   - 选择Profiles
   - 创建新的Profile
   - 选择对应的App ID和证书
   - 下载并安装Profile

## Xcode配置

### 1. 项目设置

```bash
# 进入iOS项目目录
cd ios

# 安装依赖
pod install
```

在Xcode中配置:

1. 打开项目设置
2. 选择Signing & Capabilities
3. 设置Bundle Identifier
4. 选择Team
5. 配置Provisioning Profile

### 2. 构建设置

在Build Settings中设置:

```text
CODE_SIGN_STYLE = Manual
DEVELOPMENT_TEAM = [Your Team ID]
CODE_SIGN_IDENTITY = "iPhone Distribution"
PROVISIONING_PROFILE_SPECIFIER = [Your Profile Name]
```

## 打包流程

### 1. 版本配置

在`ios/[ProjectName]/Info.plist`中设置:

```xml
<key>CFBundleShortVersionString</key>
<string>1.0.0</string>
<key>CFBundleVersion</key>
<string>1</string>
```

### 2. Archive创建

1. 选择Generic iOS Device
2. Product → Archive
3. 等待构建完成

### 3. 导出IPA

1. 打开Organizer
2. 选择最新的Archive
3. 点击Distribute App
4. 选择发布方式:
   - App Store Connect
   - Ad Hoc
   - Enterprise
   - Development

## App Store发布

### 1. App Store Connect配置

1. 创建新应用
   - 填写应用信息
   - 设置价格和可用性
   - 配置隐私政策

2. 准备提交材料
   - 应用截图
   - 应用描述
   - 关键词
   - 支持URL
   - 营销材料

### 2. 上传应用

#### 使用Xcode

1. 在Organizer中选择Archive
2. 选择"Distribute App"
3. 选择"App Store Connect"
4. 按步骤完成上传

#### 使用Transporter

1. 下载Transporter
2. 登录Apple ID
3. 选择IPA文件
4. 上传应用

## 自动化构建

### 1. Fastlane配置

```ruby
# Fastfile
default_platform(:ios)

platform :ios do
  desc "Push a new beta build to TestFlight"
  lane :beta do
    increment_build_number
    build_app(workspace: "[ProjectName].xcworkspace",
              scheme: "[ProjectName]")
    upload_to_testflight
  end

desc "Push a new release build to the App Store"
  lane :release do
    increment_build_number
    build_app(workspace: "[ProjectName].xcworkspace",
              scheme: "[ProjectName]")
    upload_to_app_store
  end
end
```

### 2. CI/CD集成

```yaml
# GitHub Actions配置
name: iOS Release

on:
  push:
    branches: [ main ]

jobs:
  build:
    runs-on: macos-latest
    steps:
    - uses: actions/checkout@v2
    - name: Set up Ruby
      uses: ruby/setup-ruby@v1
    - name: Install Fastlane
      run: gem install fastlane
    - name: Build and Upload
      run: fastlane release
      env:
        FASTLANE_USER: ${{ secrets.FASTLANE_USER }}
        FASTLANE_PASSWORD: ${{ secrets.FASTLANE_PASSWORD }}
```

## 测试发布

### 1. TestFlight

1. 在App Store Connect中设置TestFlight
2. 添加内部测试人员
3. 上传构建版本
4. 开始测试

### 2. Ad Hoc发布

1. 创建Ad Hoc Provisioning Profile
2. 添加测试设备UDID
3. 导出Ad Hoc IPA
4. 分发给测试人员

## 最佳实践

1. 证书管理
   - 安全保存证书
   - 定期更新证书
   - 备份重要证书

2. 版本控制
   - 规范版本号
   - 记录版本信息
   - 保存构建记录

3. 发布流程
   - 完整测试验证
   - 准备发布材料
   - 遵循审核指南

## 常见问题

1. 证书问题
   - 证书过期
   - 证书不匹配
   - Profile无效

2. 构建错误
   - 依赖问题
   - 签名错误
   - 配置不正确

3. 上传失败
   - 网络问题
   - 验证错误
   - 大小限制

## 参考资源

- [App Store Review Guidelines](https://developer.apple.com/app-store/review/guidelines/)
- [iOS打包指南](https://reactnative.dev/docs/publishing-to-app-store)
- [Fastlane文档](https://docs.fastlane.tools/)

## 总结

通过本文的学习,你应该已经掌握了:

1. iOS应用打包的基本流程
2. 证书和配置文件的管理
3. App Store发布的步骤
4. 自动化构建的实现
5. 常见问题的解决方案

正确的打包和发布流程是应用上线的重要环节,建议在实际项目中严格遵循流程规范,确保应用的顺利发布。