ios_app を追加
285
ios_app.md
Normal file
285
ios_app.md
Normal file
@@ -0,0 +1,285 @@
|
|||||||
|
# iOS App Store ビルドガイド
|
||||||
|
|
||||||
|
UE5プロジェクトをiOS App Storeにアップロードするための手順。
|
||||||
|
|
||||||
|
## 必要なもの
|
||||||
|
|
||||||
|
### Apple Developer 証明書
|
||||||
|
|
||||||
|
| 証明書 | 用途 |
|
||||||
|
|--------|------|
|
||||||
|
| Apple Distribution | アプリ署名 |
|
||||||
|
|
||||||
|
確認方法:
|
||||||
|
```bash
|
||||||
|
security find-identity -v -p codesigning
|
||||||
|
```
|
||||||
|
|
||||||
|
### Provisioning Profile
|
||||||
|
|
||||||
|
1. [Apple Developer](https://developer.apple.com/account/resources/profiles/list) からダウンロード
|
||||||
|
2. プロジェクトルートに `embedded.mobileprovision` として配置
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 内容確認
|
||||||
|
security cms -D -i embedded.mobileprovision
|
||||||
|
```
|
||||||
|
|
||||||
|
### App Store Connect API Key
|
||||||
|
|
||||||
|
1. [App Store Connect](https://appstoreconnect.apple.com/access/integrations/api) で作成
|
||||||
|
2. `.p8` ファイルをダウンロード
|
||||||
|
3. Issuer ID と Key ID をメモ
|
||||||
|
|
||||||
|
## 設定ファイル
|
||||||
|
|
||||||
|
### .env
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 署名証明書
|
||||||
|
IOS_CERTIFICATE_NAME="Apple Distribution: Your Name (TEAMID)"
|
||||||
|
DEVELOPMENT_TEAM="TEAMID"
|
||||||
|
|
||||||
|
# iOS Provisioning Profile
|
||||||
|
MOBILEPROVISION="/path/to/embedded.mobileprovision"
|
||||||
|
|
||||||
|
# App Store Connect API
|
||||||
|
ASC_ISSUER_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||||
|
ASC_KEY_ID="XXXXXXXXXX"
|
||||||
|
ASC_KEY_PATH="/path/to/XXXXXXXXXX.p8"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Config/DefaultEngine.ini
|
||||||
|
|
||||||
|
```ini
|
||||||
|
[/Script/IOSRuntimeSettings.IOSRuntimeSettings]
|
||||||
|
BundleDisplayName=AppName
|
||||||
|
BundleIdentifier=com.example.app
|
||||||
|
IOSTeamID=TEAMID
|
||||||
|
BundleName=com.example.app
|
||||||
|
MetalLanguageVersion=7
|
||||||
|
MinimumiOSVersion=IOS_17
|
||||||
|
bAutomaticSigning=True
|
||||||
|
bSupportsPortraitOrientation=True
|
||||||
|
bSupportsLandscapeLeftOrientation=False
|
||||||
|
bSupportsLandscapeRightOrientation=False
|
||||||
|
```
|
||||||
|
|
||||||
|
## ビルドワークフロー
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. iOSビルド
|
||||||
|
./bin/build.zsh ios
|
||||||
|
|
||||||
|
# 2. IPA作成（署名）
|
||||||
|
./bin/build.zsh ipa
|
||||||
|
|
||||||
|
# 3. App Storeにアップロード
|
||||||
|
./bin/build.zsh upload-ios
|
||||||
|
```
|
||||||
|
|
||||||
|
## コマンド詳細
|
||||||
|
|
||||||
|
### ios - UE5ビルド
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./bin/build.zsh ios
|
||||||
|
```
|
||||||
|
|
||||||
|
実行内容:
|
||||||
|
- BuildCookRun でiOS向けビルド
|
||||||
|
- `-iterate` で増分クック（高速化）
|
||||||
|
- 出力: `IOS/*.xcarchive`
|
||||||
|
|
||||||
|
### ipa - IPA作成
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./bin/build.zsh ipa
|
||||||
|
```
|
||||||
|
|
||||||
|
実行内容:
|
||||||
|
1. 最新の xcarchive を検出
|
||||||
|
2. Payload フォルダに .app をコピー
|
||||||
|
3. embedded.mobileprovision を埋め込み
|
||||||
|
4. Entitlements を抽出
|
||||||
|
5. Frameworks を署名
|
||||||
|
6. メインアプリを署名
|
||||||
|
7. ZIP圧縮して .ipa を生成
|
||||||
|
8. 出力: `build/Airse.ipa`
|
||||||
|
|
||||||
|
### upload-ios - アップロード
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./bin/build.zsh upload-ios
|
||||||
|
```
|
||||||
|
|
||||||
|
実行内容:
|
||||||
|
- `xcrun altool` でApp Store Connectにアップロード
|
||||||
|
- API Key認証（推奨）またはユーザー名/パスワード認証
|
||||||
|
|
||||||
|
## 必須ファイル
|
||||||
|
|
||||||
|
```
|
||||||
|
Project/
|
||||||
|
├── .env # 環境変数
|
||||||
|
├── embedded.mobileprovision # iOS用プロビジョニングプロファイル
|
||||||
|
├── XXXXXXXXXX.p8 # App Store Connect API Key
|
||||||
|
├── Build/
|
||||||
|
│ └── IOS/
|
||||||
|
│ └── Resources/
|
||||||
|
│ └── Assets.xcassets/
|
||||||
|
│ └── AppIcon.appiconset/ # アプリアイコン
|
||||||
|
└── Config/
|
||||||
|
└── DefaultEngine.ini # プロジェクト設定
|
||||||
|
```
|
||||||
|
|
||||||
|
## アイコン設定
|
||||||
|
|
||||||
|
### アイコン生成
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./bin/build.zsh icon [source_image.png]
|
||||||
|
```
|
||||||
|
|
||||||
|
デフォルトソース: `bin/icon/airse.png`
|
||||||
|
|
||||||
|
生成先: `Build/IOS/Resources/Assets.xcassets/AppIcon.appiconset/`
|
||||||
|
|
||||||
|
### 必要なアイコンサイズ
|
||||||
|
|
||||||
|
| ファイル名 | サイズ | 用途 |
|
||||||
|
|-----------|--------|------|
|
||||||
|
| IPhoneIcon60@2x.png | 120x120 | iPhone |
|
||||||
|
| IPadIcon76@2x.png | 152x152 | iPad |
|
||||||
|
| IPadIcon83.5@2x.png | 167x167 | iPad Pro |
|
||||||
|
| Icon1024.png | 1024x1024 | App Store |
|
||||||
|
|
||||||
|
## トラブルシューティング
|
||||||
|
|
||||||
|
### No valid iOS code signing certificates found
|
||||||
|
|
||||||
|
**原因**: Apple Distribution証明書がない
|
||||||
|
|
||||||
|
**解決**:
|
||||||
|
1. Keychain Access で証明書を確認
|
||||||
|
2. なければ Apple Developer から作成・ダウンロード
|
||||||
|
|
||||||
|
### mobileprovision not found
|
||||||
|
|
||||||
|
**原因**: Provisioning Profileが配置されていない
|
||||||
|
|
||||||
|
**解決**:
|
||||||
|
```bash
|
||||||
|
# Apple Developer からダウンロードして配置
|
||||||
|
cp ~/Downloads/profile.mobileprovision embedded.mobileprovision
|
||||||
|
```
|
||||||
|
|
||||||
|
### The bundle identifier does not match
|
||||||
|
|
||||||
|
**原因**: Bundle IDがProvisioning Profileと一致しない
|
||||||
|
|
||||||
|
**解決**:
|
||||||
|
1. `DefaultEngine.ini` の `BundleIdentifier` を確認
|
||||||
|
2. Provisioning Profileが正しいBundle IDで作成されているか確認
|
||||||
|
|
||||||
|
### クック失敗 (ExitCode=25)
|
||||||
|
|
||||||
|
**原因**: アセットのクックエラー
|
||||||
|
|
||||||
|
**解決**:
|
||||||
|
1. `-iterate` を外してフルクック
|
||||||
|
2. エラーログを確認: `build_ios.log`
|
||||||
|
|
||||||
|
### アップロード失敗
|
||||||
|
|
||||||
|
**原因**: API Keyの設定ミス
|
||||||
|
|
||||||
|
**解決**:
|
||||||
|
1. `.env` の ASC_* 変数を確認
|
||||||
|
2. `.p8` ファイルのパスを確認
|
||||||
|
3. altool は `AuthKey_<KEY_ID>.p8` という名前を期待する
|
||||||
|
|
||||||
|
## 署名の仕組み
|
||||||
|
|
||||||
|
### 手動署名フロー
|
||||||
|
|
||||||
|
```
|
||||||
|
1. Provisioning Profile から Entitlements を抽出
|
||||||
|
security cms -D -i embedded.mobileprovision > profile.plist
|
||||||
|
PlistBuddy -x -c "Print :Entitlements" profile.plist > entitlements.plist
|
||||||
|
|
||||||
|
2. Frameworks を署名（あれば）
|
||||||
|
codesign -f -s "$CERT" Framework.framework
|
||||||
|
|
||||||
|
3. メインアプリを署名
|
||||||
|
codesign -f -s "$CERT" --entitlements entitlements.plist App.app
|
||||||
|
|
||||||
|
4. IPA作成
|
||||||
|
zip -r App.ipa Payload/
|
||||||
|
```
|
||||||
|
|
||||||
|
### 自動署名 vs 手動署名
|
||||||
|
|
||||||
|
| 項目 | 自動署名 | 手動署名 |
|
||||||
|
|------|---------|---------|
|
||||||
|
| 設定 | `bAutomaticSigning=True` | `bAutomaticSigning=False` |
|
||||||
|
| Profile | Xcode管理 | 手動配置 |
|
||||||
|
| 柔軟性 | 低 | 高 |
|
||||||
|
| CI/CD | 困難 | 容易 |
|
||||||
|
|
||||||
|
## デバイス要件
|
||||||
|
|
||||||
|
### 最小iOSバージョン
|
||||||
|
|
||||||
|
`DefaultEngine.ini`:
|
||||||
|
```ini
|
||||||
|
MinimumiOSVersion=IOS_17
|
||||||
|
```
|
||||||
|
|
||||||
|
選択肢:
|
||||||
|
- `IOS_15` - iOS 15以上
|
||||||
|
- `IOS_16` - iOS 16以上
|
||||||
|
- `IOS_17` - iOS 17以上（推奨）
|
||||||
|
|
||||||
|
### 対応向き
|
||||||
|
|
||||||
|
```ini
|
||||||
|
bSupportsPortraitOrientation=True
|
||||||
|
bSupportsLandscapeLeftOrientation=False
|
||||||
|
bSupportsLandscapeRightOrientation=False
|
||||||
|
```
|
||||||
|
|
||||||
|
## ビルドログ
|
||||||
|
|
||||||
|
ログファイルの場所:
|
||||||
|
- UE5ビルドログ: `build_ios.log`
|
||||||
|
- Xcodeログ: `~/Library/Logs/Unreal Engine/LocalBuildLogs/`
|
||||||
|
|
||||||
|
## Mac vs iOS の違い
|
||||||
|
|
||||||
|
| 項目 | Mac | iOS |
|
||||||
|
|------|-----|-----|
|
||||||
|
| 出力形式 | .pkg | .ipa |
|
||||||
|
| Profile | .provisionprofile | .mobileprovision |
|
||||||
|
| Sandbox | 必須（EpicWebHelper署名） | 不要 |
|
||||||
|
| Assets.car | 再ビルド必要 | UE5が生成 |
|
||||||
|
| アップロード | `-t macos` | `-t ios` |
|
||||||
|
|
||||||
|
## 参考コマンド
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 証明書一覧
|
||||||
|
security find-identity -v -p codesigning
|
||||||
|
|
||||||
|
# Provisioning profile の内容確認
|
||||||
|
security cms -D -i embedded.mobileprovision
|
||||||
|
|
||||||
|
# IPA の内容確認
|
||||||
|
unzip -l Airse.ipa
|
||||||
|
|
||||||
|
# アプリの署名確認
|
||||||
|
codesign -dv --verbose=4 Payload/Airse.app
|
||||||
|
|
||||||
|
# Entitlements 確認
|
||||||
|
codesign -d --entitlements - Payload/Airse.app
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user