2

ios_app

syui edited this page 2025-12-22 19:13:29 +00:00

Table of Contents

• iOS App Store ビルドガイド
• 必要なもの
• Apple Developer 証明書
• Provisioning Profile
• App Store Connect API Key
• 設定ファイル
• .env
• Config/DefaultEngine.ini
• ビルドワークフロー
• コマンド詳細
• ios - UE5ビルド
• ipa - IPA作成
• upload-ios - アップロード
• 必須ファイル
• アイコン設定
• アイコン生成
• 必要なアイコンサイズ
• トラブルシューティング
• No valid iOS code signing certificates found
• mobileprovision not found
• The bundle identifier does not match
• クック失敗 (ExitCode=25)
• アップロード失敗
• 署名の仕組み
• 手動署名フロー
• 自動署名 vs 手動署名
• デバイス要件
• 最小iOSバージョン
• 対応向き
• ビルドログ
• Mac vs iOS の違い
• 参考コマンド

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

iOS App Store ビルドガイド

UE5プロジェクトをiOS App Storeにアップロードするための手順。

必要なもの

Apple Developer 証明書

証明書	用途
Apple Distribution	アプリ署名

確認方法:

security find-identity -v -p codesigning

Provisioning Profile

1. Apple Developer からダウンロード
2. プロジェクトルートに embedded.mobileprovision として配置

# 内容確認
security cms -D -i embedded.mobileprovision

App Store Connect API Key

1. App Store Connect で作成
2. .p8 ファイルをダウンロード
3. Issuer ID と Key ID をメモ

設定ファイル

.env

# 署名証明書
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

[/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

ビルドワークフロー

# 1. iOSビルド
./bin/build.zsh ios

# 2. IPA作成（署名）
./bin/build.zsh ipa

# 3. App Storeにアップロード
./bin/build.zsh upload-ios

コマンド詳細

ios - UE5ビルド

./bin/build.zsh ios

実行内容:

• BuildCookRun でiOS向けビルド
• -iterate で増分クック（高速化）
• 出力: IOS/*.xcarchive

ipa - IPA作成

./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 - アップロード

./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             # プロジェクト設定

アイコン設定

アイコン生成

./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が配置されていない

解決:

# 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:

MinimumiOSVersion=IOS_17

選択肢:

• IOS_15 - iOS 15以上
• IOS_16 - iOS 16以上
• IOS_17 - iOS 17以上（推奨）

対応向き

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

参考コマンド

# 証明書一覧
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

• App
• Technical Specifications

project

• Airse
• Aicard
• Aiat

func

• Vmode

page

• Privacy Policy

---

[ja]

project

• Airse
• Aicard
• Aiat

asset

• Game Animation Sample Project
• Control Rig Sample
• Nice Interaction System
• SoStylized
• Controller Support

plugin

• VRM4U
• HttpBlueprint
• Web Browser
• WorldScape Plugin
• Generic Combat System
• Dragon IK Plugin

platform

• Windows
• Mac/iOS
• Linux
• Mac App Store
• iOS App Store

ref

• Pokemon
• Mario
• Zelda

© syui