mac_app を追加
247
mac_app.md
Normal file
247
mac_app.md
Normal file
@@ -0,0 +1,247 @@
|
||||
# Mac App Store / TestFlight ビルドガイド
|
||||
|
||||
UE5プロジェクトをMac App Store / TestFlightにアップロードするための手順。
|
||||
|
||||
## 必要なもの
|
||||
|
||||
### Apple Developer 証明書
|
||||
|
||||
| 証明書 | 用途 |
|
||||
|--------|------|
|
||||
| Apple Distribution | アプリ署名 |
|
||||
| 3rd Party Mac Developer Installer | PKG署名 |
|
||||
|
||||
確認方法:
|
||||
```bash
|
||||
security find-identity -v -p codesigning
|
||||
```
|
||||
|
||||
### Provisioning Profile
|
||||
|
||||
1. [Apple Developer](https://developer.apple.com/account/resources/profiles/list) からダウンロード
|
||||
2. プロジェクトルートに `embedded.provisionprofile` として配置
|
||||
|
||||
```bash
|
||||
# UUIDを確認
|
||||
security cms -D -i embedded.provisionprofile | grep -A1 UUID
|
||||
```
|
||||
|
||||
### 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"
|
||||
|
||||
# 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/MacTargetPlatform.XcodeProjectSettings]
|
||||
CodeSigningTeam=TEAMID
|
||||
bUseModernXcode=true
|
||||
bUseAutomaticCodeSigning=true
|
||||
BundleIdentifier=com.example.app
|
||||
CodeSigningPrefix=com.example
|
||||
bUseAppStoreConnect=True
|
||||
AppStoreConnectIssuerID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||||
AppStoreConnectKeyID=XXXXXXXXXX
|
||||
AppStoreConnectKeyPath=(FilePath="path/to/key.p8")
|
||||
```
|
||||
|
||||
## ビルドワークフロー
|
||||
|
||||
```bash
|
||||
# 1. Macビルド
|
||||
./bin/build.zsh mac
|
||||
|
||||
# 2. PKG作成（アイコン差し替え + 署名）
|
||||
./bin/build.zsh pkg
|
||||
|
||||
# 3. アイコン検証（オプション）
|
||||
./bin/verify-icon.zsh
|
||||
|
||||
# 4. TestFlightにアップロード
|
||||
./bin/build.zsh upload-mac
|
||||
```
|
||||
|
||||
## コマンド詳細
|
||||
|
||||
### mac - UE5ビルド
|
||||
|
||||
```bash
|
||||
./bin/build.zsh mac
|
||||
```
|
||||
|
||||
実行内容:
|
||||
- BuildCookRun でMac向けビルド
|
||||
- `-distribution` フラグでApp Store配布用
|
||||
- `-iterate` で増分クック（高速化）
|
||||
- 出力: `Mac/*.xcarchive`
|
||||
|
||||
### pkg - PKG作成
|
||||
|
||||
```bash
|
||||
./bin/build.zsh pkg
|
||||
```
|
||||
|
||||
実行内容:
|
||||
1. 最新の xcarchive を検出
|
||||
2. カスタムアイコンに差し替え（AppIcon.icns + Assets.car再ビルド）
|
||||
3. EpicWebHelper に sandbox entitlements で署名
|
||||
4. メインアプリを再署名
|
||||
5. `xcodebuild -exportArchive` でPKG生成
|
||||
6. 出力: `build/Airse.pkg`
|
||||
|
||||
### upload-mac - アップロード
|
||||
|
||||
```bash
|
||||
./bin/build.zsh upload-mac
|
||||
```
|
||||
|
||||
実行内容:
|
||||
- `xcrun altool` でApp Store Connectにアップロード
|
||||
- API Key認証（推奨）またはユーザー名/パスワード認証
|
||||
|
||||
## 必須ファイル
|
||||
|
||||
```
|
||||
Project/
|
||||
├── .env # 環境変数
|
||||
├── embedded.provisionprofile # Mac用プロビジョニングプロファイル
|
||||
├── XXXXXXXXXX.p8 # App Store Connect API Key
|
||||
├── Build/
|
||||
│ └── Mac/
|
||||
│ └── Resources/
|
||||
│ ├── AppIcon.icns # カスタムアイコン
|
||||
│ └── Sandbox.Server.entitlements # サンドボックス設定
|
||||
└── Config/
|
||||
└── DefaultEngine.ini # プロジェクト設定
|
||||
```
|
||||
|
||||
## Sandbox Entitlements
|
||||
|
||||
Mac App Storeでは、すべての実行ファイルにサンドボックス権限が必要。
|
||||
|
||||
### Sandbox.Server.entitlements
|
||||
|
||||
```xml
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>com.apple.security.app-sandbox</key>
|
||||
<true/>
|
||||
<key>com.apple.security.inherit</key>
|
||||
<true/>
|
||||
</dict>
|
||||
</plist>
|
||||
```
|
||||
|
||||
### EpicWebHelper 署名
|
||||
|
||||
UE5のEpicWebHelper（CEFベースのWebブラウザヘルパー）は別途署名が必要:
|
||||
|
||||
```bash
|
||||
codesign -f -s "Apple Distribution: ..." \
|
||||
--entitlements Sandbox.Server.entitlements \
|
||||
"Airse.app/Contents/UE/Engine/Binaries/Mac/EpicWebHelper"
|
||||
```
|
||||
|
||||
これは `create_pkg()` で自動実行される。
|
||||
|
||||
## トラブルシューティング
|
||||
|
||||
### No profiles for 'bundle.id'
|
||||
|
||||
**原因**: Provisioning profileがインストールされていない
|
||||
|
||||
**解決**:
|
||||
```bash
|
||||
# UUIDを取得
|
||||
PROFILE_UUID=$(security cms -D -i embedded.provisionprofile | grep -A1 UUID | tail -1 | sed 's/.*<string>\(.*\)<\/string>.*/\1/')
|
||||
|
||||
# 正しい場所にコピー
|
||||
cp embedded.provisionprofile ~/Library/MobileDevice/Provisioning\ Profiles/${PROFILE_UUID}.provisionprofile
|
||||
```
|
||||
|
||||
### Certificate mismatch
|
||||
|
||||
**原因**: "3rd Party Mac Developer Installer" 証明書がない
|
||||
|
||||
**解決**: Keychain Accessで証明書を確認、なければApple Developerから作成
|
||||
|
||||
### App sandbox not enabled on EpicWebHelper
|
||||
|
||||
**原因**: EpicWebHelperにサンドボックス権限がない
|
||||
|
||||
**解決**: `create_pkg()` で自動署名される。手動で署名する場合:
|
||||
```bash
|
||||
codesign -f -s "$CERT" --entitlements Sandbox.Server.entitlements EpicWebHelper
|
||||
codesign -f -s "$CERT" --entitlements Sandbox.Server.entitlements Airse.app
|
||||
```
|
||||
|
||||
### Missing asset catalog
|
||||
|
||||
**原因**: Assets.car が削除された
|
||||
|
||||
**解決**: Assets.carを削除せず、`actool` で再ビルドする（現在のスクリプトで対応済み）
|
||||
|
||||
### アイコンが変わらない
|
||||
|
||||
**原因**: Assets.car にデフォルトアイコンが含まれている
|
||||
|
||||
**解決**:
|
||||
1. キャッシュクリア: `rm -rf Saved/StagedBuilds Binaries/Mac`
|
||||
2. `./bin/build.zsh pkg` を再実行
|
||||
3. `./bin/verify-icon.zsh` で確認
|
||||
|
||||
## ビルドログ
|
||||
|
||||
ログファイルの場所:
|
||||
- UE5ビルドログ: `build_mac.log`
|
||||
- Xcodeログ: `~/Library/Logs/Unreal Engine/LocalBuildLogs/`
|
||||
|
||||
## バージョン管理
|
||||
|
||||
TestFlightにアップロードするたびにビルド番号を上げる必要がある。
|
||||
|
||||
`Config/DefaultGame.ini`:
|
||||
```ini
|
||||
[/Script/EngineSettings.GeneralProjectSettings]
|
||||
ProjectVersion=1.0.0
|
||||
```
|
||||
|
||||
または UE Editor の Project Settings > Project > Description で設定。
|
||||
|
||||
## 参考コマンド
|
||||
|
||||
```bash
|
||||
# 証明書一覧
|
||||
security find-identity -v -p codesigning
|
||||
|
||||
# Provisioning profile の内容確認
|
||||
security cms -D -i embedded.provisionprofile
|
||||
|
||||
# PKG の内容確認
|
||||
pkgutil --expand Airse.pkg /tmp/pkg_contents
|
||||
|
||||
# アプリの署名確認
|
||||
codesign -dv --verbose=4 Airse.app
|
||||
|
||||
# Entitlements 確認
|
||||
codesign -d --entitlements - Airse.app
|
||||
```
|
||||
Reference in New Issue
Block a user