メインコンテンツまでスキップ

モバイルアプリのカスタマイズ

このガイドでは、Android および iOS アプリをホワイトラベルにカスタマイズする方法を説明します。独自のプロダクト名とビジュアルアイデンティティでアプリをリブランドする際はこの手順に従ってください。


カスタマイズできる内容

  • アプリ名(ホーム画面のアイコン下に表示)
  • アプリアイコン
  • 起動画面 / スプラッシュスクリーン
  • プライマリカラーとアクセントカラー
  • デフォルトのインスタンス URL(ログイン画面に事前入力)
  • バンドル識別子 / パッケージ名(ストア申請に必要)

Android のカスタマイズ

アプリ名

app/src/main/res/values/strings.xml を編集します:

<string name="app_name">あなたのアプリ名</string>

パッケージ名

  1. Android Studio でパッケージフォルダを右クリックし、Refactor → Rename でパッケージを変更します。
  2. app/build.gradleapplicationId を更新します:
    applicationId "com.yourcompany.yourapp"

アプリアイコン

以下のファイルを置き換えます:

  • app/src/main/res/mipmap-hdpi/ic_launcher.png
  • app/src/main/res/mipmap-mdpi/ic_launcher.png
  • app/src/main/res/mipmap-xhdpi/ic_launcher.png
  • app/src/main/res/mipmap-xxhdpi/ic_launcher.png
  • app/src/main/res/mipmap-xxxhdpi/ic_launcher.png

Android Studio の Image Asset StudioFile → New → Image Asset)を使用すると、1024x1024 の元画像から全サイズを生成できます。

カラー

app/src/main/res/values/colors.xml を編集します:

<color name="colorPrimary">#E63946</color>
<color name="colorPrimaryDark">#C1121F</color>
<color name="colorAccent">#2EC4B6</color>

デフォルトのインスタンス URL

プロジェクト内の定数を見つけ(Constants.kt または Config.kt ファイルで DEFAULT_BASE_URL などを検索)、LeadHub インスタンスの URL に設定します。これによりユーザーの URL フィールドが事前入力され、手動で入力する必要がなくなります。


iOS のカスタマイズ

アプリ名

  1. Xcode で Navigator のプロジェクトルートをクリックします。
  2. Targets でアプリターゲットを選択します。
  3. General タブで Display Name をプロダクト名に変更します。

バンドル識別子

同じ General タブで Bundle Identifier を変更します:

com.yourcompany.yourapp

一意であり、Apple Developer アカウントに登録されている必要があります。

アプリアイコン

  1. Xcode で Assets.xcassets を開きます。
  2. AppIcon をクリックします。
  3. アイコン画像を適切なスロットにドラッグします。App Store には 1024x1024 の画像が必要で、デバイス用には様々な小サイズが必要です。

Xcode のアセットカタログが必要なサイズを教えてくれます。makeappicon.com などのツールを使用して、1枚の元画像から全サイズを生成できます。

起動画面

Xcode で LaunchScreen.storyboard を編集して、アプリ読み込み中に表示されるスプラッシュスクリーンをカスタマイズします。

カラー

プロジェクト内の Colors.swift または Theme.swift ファイルを見つけ、プライマリカラーとアクセントカラーの値を更新します:

struct Theme {
static let primaryColor = UIColor(hex: "#E63946")
static let accentColor = UIColor(hex: "#2EC4B6")
}

または Assets.xcassets → Colors のカラーアセットを更新します。

デフォルトのインスタンス URL

Constants.swift または Config.swift ファイルを見つけて更新します:

static let defaultBaseURL = "https://crm.yourcompany.com"

プッシュ通知の設定

両アプリともプラットフォームごとに個別のプッシュ通知認証情報が必要です。FCM(Android)と APNs(iOS)の設定手順については、Android および iOS 開発者ガイドを参照してください。

プッシュ認証情報を設定した後、適切なキーで LeadHub サーバーの環境設定を更新します。この部分はシステム管理者が担当します。


ストア申請チェックリスト

Google Play または Apple App Store に申請する前に:

  • アプリ名が自社製品のものになっている("LeadHub" ではない)
  • パッケージ名 / Bundle ID が自社ドメインに更新されている
  • アプリアイコンが自社ブランドのものに置き換えられている(全必要サイズ)
  • 起動画面が更新されている
  • カラーが自社ブランドに合っている
  • デフォルトのインスタンス URL が設定されている(任意だが推奨)
  • プッシュ通知の認証情報が設定されている
  • プライバシーポリシー URL が追加されている(両ストアで必須)
  • App Store / Play Store のスクリーンショットが準備されている
  • プロダクト用の説明文が書かれている