クイックスタート
このガイドでは、Fenfaの起動、製品の作成、ビルドのアップロード、ダウンロードページの共有を5分以内に実行する手順を説明します。
ステップ1: Fenfaを起動する
bash
docker run -d --name fenfa -p 8000:8000 fenfa/fenfa:latestブラウザでhttp://localhost:8000/adminを開きます。デフォルトの管理トークンdev-admin-tokenでログインします。
ステップ2: 製品を作成する
- 管理パネルのサイドバーで製品をクリックします。
- 製品を作成をクリックします。
- 製品の詳細を入力します：
- 名前: アプリ名（例：「MyApp」）
- スラッグ: URLフレンドリーな識別子（例：「myapp」）-- これがダウンロードページのURLになります
- 説明: アプリの簡単な説明
- 保存をクリックします。
ステップ3: バリアントを追加する
バリアントはプラットフォーム固有のビルドターゲットを表します。各製品には複数のバリアント（iOS、Android、macOSなど）を持てます。
- 作成した製品を開きます。
- バリアントを追加をクリックします。
- バリアントを設定します：
- プラットフォーム: ターゲットプラットフォームを選択（例：「ios」）
- 表示名: 人間が読める名前（例：「iOS App Store」）
- 識別子: バンドルIDまたはパッケージ名（例：「com.example.myapp」）
- アーキテクチャ: CPUアーキテクチャ（例：「arm64」）
- インストーラータイプ: ファイルタイプ（例：「ipa」、「apk」、「dmg」）
- 保存をクリックします。
ステップ4: ビルドをアップロードする
管理パネルから
- 作成したバリアントに移動します。
- リリースをアップロードをクリックします。
- ビルドファイル（IPA、APK、DMGなど）を選択します。
- バージョンとチェンジログを入力します（オプション -- FenfaはIPA/APKメタデータから自動検出します）。
- アップロードをクリックします。
APIから（CI/CD）
ビルドパイプラインから直接アップロードします：
bash
curl -X POST http://localhost:8000/upload \
-H "X-Auth-Token: dev-upload-token" \
-F "variant_id=var_xxxxx" \
-F "app_file=@build/MyApp.ipa" \
-F "version=1.0.0" \
-F "changelog=Initial release"スマートアップロード
自動メタデータ検出のためにスマートアップロードエンドポイントを使用します：
bash
curl -X POST http://localhost:8000/admin/api/smart-upload \
-H "X-Auth-Token: dev-admin-token" \
-F "variant_id=var_xxxxx" \
-F "app_file=@build/MyApp.ipa"これにより、アップロードされたパッケージからバンドルID、バージョン、ビルド番号、アイコンが自動的に抽出されます。
ステップ5: ダウンロードページを共有する
アプリは以下で利用可能になります：
http://localhost:8000/products/myappこのページの機能：
- プラットフォーム検出 -- 訪問者のデバイスに基づいて正しいダウンロードボタンを自動的に表示します。
- QRコード -- スキャンしてモバイルデバイスでダウンロードページを開きます。
- リリースごとのチェンジログ -- 各リリースにはバージョンとチェンジログが表示されます。
- iOS OTAインストール -- iOSビルドは直接インストールに
itms-services://を使用します（プロダクションではHTTPSが必要）。
このURLまたはQRコードをテスターやステークホルダーと共有します。
次のステップ
| 目標 | ガイド |
|---|---|
| UDIDバインディングを使用したiOSアドホック配布のセットアップ | iOS配布 |
| スケーラブルなファイルストレージのためのS3/R2設定 | 設定 |
| CI/CDからのアップロード自動化 | アップロードAPI |
| HTTPSを使用したNginxへのデプロイ | プロダクションデプロイ |
| Android、macOS、Windowsバリアントの追加 | プラットフォームバリアント |