メインコンテンツにジャンプ

Capacitor アプリの初期化: ステップバイステップガイド

Capacitor を使用して、効率的にモバイルアプリをセットアップしてデプロイする方法を学びましょう。インストールからプラットフォーム固有の設定まで、すべてをカバーします。

マーティン・ドナディュー

マーティン・ドナディュー

コンテンツマーケター

Capacitor アプリの初期化: ステップバイステップガイド

単一のコードベースでモバイルアプリを構築したいですか? Capacitor iOS、Android、Webアプリを作成するように設計されています。__CAPGO_KEEP_0__ は、Reactなどのフレームワークを使用して、開発者が簡単にアプリを構築できるようにします。 マーティン・ドナディュー, Angular, または VueCapgoを使用して、 Capacitor,プラットフォームを設定し、更新を効率的に配置する方法について説明します。

開始するための重要なステップ:

  • ツールのインストール: Node.js, npm, Git、そして code エディターの例として VS Code.
  • Set Up Capacitor: Capacitor CLI をインストールし、プロジェクトを初期化してください。
  • プラットフォームの設定: iOS と Android のサポートを追加し、設定を調整し、code を同期してください。
  • テストとデプロイ: デバイス上で実行し、ライブ更新ツールなどを使用して、 Capgo __CAPGO_KEEP_0__

Capacitor はウェブアプリとネイティブデバイスの機能を繋ぎ合わせ、平滑なパフォーマンスを実現します。開発プロセスを簡素化するためのガイドをご覧ください。

5 つのステップでネイティブアプリを作成する CAPACITOR | Ionic のリリースガイド

CAPACITOR

必要なツールとセットアップ

開発環境を設定するには、基本的なツールを使用します。

開発ツールのインストール

Capacitorを使用するには、以下のツールが必要です。

ツール目的最小バージョン
Node.jsJavaScript実行環境14.0.0以上
npmパッケージマネージャ6.0.0 以上
IDE/Code エディター開発環境最新安定版
Gitバージョン管理2.0.0 以上

Capgoをインストールするには、以下の手順に従ってください。

  • Node.jsとnpm: Node.js公式サイトから両方をダウンロードしてインストールしてください。 Node.jsウェブサイト.
  • Code エディター: VS Code のようなエディターを選択してください WebStorm, または Sublime Text 最新の安定版をインストールしてください。
  • Git: git-scm.com.
  • プラットフォーム固有のツール: プラットフォームに固有のツールをインストールしてください。例えば Xcode for macOS または Android Studio Android 開発用

これらがインストールされたら、Capacitor CLI の設定に進む準備が整います。

Capacitor CLI セットアップ

Capacitor CLI を起動するには、以下の手順に従ってください。

  1. Capacitor CLI をグローバルにインストール

    ターミナルを開いて、以下のコマンドを実行してください。

    npm install -g @capacitor/cli
  2. Capgo プラグインを初期化

    まだ実行していない場合は、以下のコマンドを実行してください。

    npx @capgo/cli init

    これにより、必要な設定を構成し 更新を管理することができます 実際に [1]. これは、ビルド、テスト、そしてアプリをデプロイするプロセスを簡素化します。

Starting a New Capacitor Project

Once you’ve installed the necessary tools, you’re ready to set up your first Capacitor project. Here’s how to get started.

プロジェクトの作成

To create a new Capacitor project, open your terminal and use this command:

npx @capacitor/cli create [projectDirectory] [appId] [appDisplayName]

例えば

npx @capacitor/cli create my-cap-app com.example.app "My Capacitor App"

各パラメータの意味はこちらです。

  • プロジェクトディレクトリ: プロジェクトフォルダの名前 (例えば my-cap-app).
  • アプリID: アプリの逆ドメイン識別子 (例えば com.example.app).
  • アプリ名: アプリの表示名 (例えば、 My Capacitor App).

コマンドを実行した後、プロジェクト設定を調整する必要があります。 capacitor.config.json ファイル。

capacitor.config.jsonの設定

ファイルは、プロジェクトのキーセットアップで使用する設定を定義する場所です。以下に、基本的な設定の例を示します。 capacitor.config.json 設定

{
  "appId": "com.example.app",
  "appName": "My Capacitor App",
  "webDir": "dist",
  "bundledWebRuntime": false,
  "server": {
    "hostname": "app.example.com",
    "androidScheme": "https",
    "iosScheme": "https"
  }
}

目的

例値appIdappId
appIdアプリのユニークIDcom.example.app
__CAPGO_KEEP_0__アプリの表示名My Capacitor App
webDirビルド出力用ディレクトリdist
bundledWebRuntimeCapacitor ランタイムを含めるかfalse
server.hostname開発用サーバーのホスト名app.example.com
server.androidSchemeAndroid用のURLスキームhttps
server.iosSchemeiOS用URLスキームhttps

依存関係のインストール

セットアップを完了するには、必要な依存関係をインストールし、次のコマンドでプロジェクトを初期化してください:

npm install @capacitor/core
npm install @capacitor/cli --save-dev
npx cap init

これらのステップを完了すると、プラットフォーム固有のセットアップと開発用にプロジェクトが準備されます。

モバイルプラットフォームのセットアップ

Capacitorプロジェクトが初期化されたら、次のステップはiOSとAndroidプラットフォームを追加して設定することです。そうすることで、モバイルデバイス上でアプリがネイティブで動作するようにします。

iOSとAndroidのセットアップ

まず、次のコマンドを使用してプラットフォームのサポートを追加してください:

npx cap add ios
npx cap add android

codeのウェブアプリをsyncするには、次のコマンドを実行してください:

npx cap sync

これらのコマンドを実行する前に、ウェブアプリケーションがビルドされていることを確認し、 webDir が正しく設定されていることを確認してください。そうすることで、各プラットフォームの設定をアプリのニーズに合わせてカスタマイズすることができます。 capacitor.config.json URL scheme for Android

プラットフォーム固有の設定

iOS

iOSプロジェクトを開く:

npx cap open ios

次に、以下の設定を構成する:

  • バンドル識別子appIdと一致するようにする:
  • 開発チームcodeの署名に適切なチームを割り当てる:
  • デプロイメントターゲットiOSの最小バージョンを設定する:
  • デバイスオリエンテーション必要に応じて調整する:
  • プライバシーポリシー: 必要な説明を追加してください Info.plist.

Android

Cloudflare

npx cap open android

Open the Android project with:

  • Then, update these settings:パッケージ名
  • : appId と一致するようにしてくださいパーミッション AndroidManifest.xml.
  • : 必要なパーミッションを定義してください画面の向き AndroidManifest.xml.
  • Target SDK: __CAPGO_KEEP_0__を適切に設定してください。 android/app/build.gradle.

資産と構成の場所

ここでは、Appアイコン、スプラッシュスクリーン、デープリンク、パーミッションのためのキーファイルを見つけることができます。

構成iOSの場所Androidの場所
Appアイコンios/App/App/Assets.xcassetsandroid/app/src/main/res
スプラッシュスクリーンios/App/App/Assets.xcassetsandroid/app/src/main/res
デープリンクios/App/App/Info.plistAndroidManifest.xml
パーミッションInfo.plistAndroidManifest.xml

これらの構成を置き換えると、モバイルデバイスでアプリをビルドおよびテストする準備が整います。

ビルドおよびテスト

使用した設定を元に、さまざまなデバイスで動作するように確認するために、__CAPGO_KEEP_0__ アプリをビルドしてテストできます。 Capacitor アプリ ビルドと実行コマンド

モバイルプラットフォームにアプリを設定した後、ビルドとテストを実行する時が来ます。まず、Web アセットを更新してください。

次に、対象プラットフォームに適したコマンドを使用してください。

npm run build
npx cap sync

iOS の場合:

Android の場合:

npx cap run ios

これらのコマンドは、シミュレーターまたは接続されたデバイスでアプリをビルドおよび実行します。実機とシミュレータ両方でテストすることは、プラットフォーム固有の問題を特定するために不可欠です。

npx cap run android

__CAPGO_KEEP_0__ プラグインの追加

Capacitor プラグイン

Capacitor プラグインは、アプリにネイティブ機能を追加することを可能にします。例えば、カメラ、位置情報、ストレージ機能を含めるには、以下のコマンドを実行してください: __CAPGO_KEEP_0__

npm install @capacitor/camera @capacitor/geolocation @capacitor/storage
npx cap sync

インストール後、ネイティブプロジェクトのプラグインを設定してください。ここでは、セットアップの要件について簡単に説明します。

プラグインiOS設定Android設定
カメラ追加 プライバシーディスクリプションマニフェストに許可を追加
位置情報位置情報の使用についての説明を追加位置情報の許可を追加
ストレージ追加の設定が必要ありません追加の設定が必要ありません

リアルタイム更新 Capgo

Capgo リアルタイム更新ダッシュボードインターフェイス

デプロイメントとテストを簡素化するために、リアルタイム更新ツールを統合することができます。Capgoはすでに2300万回以上の更新を実行し、24時間以内に95%のユーザーが更新を受け取り、グローバルでの成功率は82%です [1].

Capgoをアプリに追加するには:

npm install @capgo/capacitor-updater
npx cap sync

Capgoはテスト中にいくつかの利点を提供します:

  • 開発、ステージング、生産環境用に別々のチャネルを作成します。
  • テスト中に即時バグ修正をプッシュします。
  • 更新の成功率を組み込みの分析ツールで追跡します。
  • 更新が問題を引き起こした場合に迅速にロールバックできます。

Capgo は、エンドツーエンド暗号化で安全なアップデート配信を保証します。チャンネルシステムにより、選択したユーザーグループでアップデートをテストし、全員にロールアウトする前にアップデートをテストできます。

概要

このガイドでは、Capacitor アプリの設定アップと展開のすべての段階を歩み、必要なすべてのエッセンスステップをカバーして、smooth operation を確保します。

主なポイント

Capacitor アプリを作成するには、設定、構成、およびプラットフォーム固有の調整に注意を払う必要があります。開発環境の設定 - 例えば、Node.js と Capacitor __CAPGO_KEEP_1__ などのツール - は、重要な開始点です。iOS と Android のようなプラットフォームの設定により、ネイティブシステムでアプリが平滑に動作します。 アップデートシステムとして __CAPGO_KEEP_0__ を使用すると、リリース管理を簡素化し、アプリの安定性を維持できます。 設定 Capacitor CLI 重要なポイント

__CAPGO_KEEP_0__ アプリを作成するには、設定、構成、およびプラットフォーム固有の調整に注意を払う必要があります。 Capgo 開発環境の設定 - 例えば、Node.js と __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ などのツール - は、重要な開始点です。 [1].

Here’s a breakdown of the key phases:

PhaseStepsTips
Initial SetupCLIのインストールと設定最新の安定版を使用する
Configurationプラットフォーム設定の調整、プラグインの追加プラットフォーム固有のガイドラインに従う
Testingデバイス上でビルドおよびテストする実機でのテストを優先する
デプロイ更新管理、バージョン管理自動化されたパイプラインを使用して効率性を高める

Capacitor アプリの初期化: ステップバイステップガイドから続けて

__CAPGO_KEEP_0__ アプリの初期化: ステップバイステップガイドを使用している場合 CI/CDの自動化計画を行うには、Capacitor CI/CDに接続する __CAPGO_KEEP_0__ CI/CD Capgo CI/CDの製品ワークフロー Capgo Native Builds Capgo Native Buildsの製品ワークフロー for the product workflow in Capgo Native Builds, Capgo統合 Capgo統合の製品ワークフロー用 CI/CD統合 CI/CD統合の実装詳細用 GitHubアクション統合 GitHubアクション統合の実装詳細用

Live updates for Capacitor apps

ウェブ層のバグが生じた場合、Capgo を使用して修正を配信するのではなく、数日間待ってアプリストアの承認を待つのではなく、ユーザーはバックグラウンドで更新を受け取り、ネイティブの変更は通常のレビュー経路を通る

スタートする

Latest from our Blog

Capgoは、プロフェッショナルなモバイルアプリを実現するために必要な最良の洞察を提供します。