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

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

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

Capacitor アプリケーション初期化: ステップバイステップガイド

モバイルアプリを単一のコードベースで作成したい? Capacitor Capacitorを使用したLive Updateプラットフォーム React, Angular, または VueCapacitorアプリの初期化手順のステップバイステップガイドです。 Capacitor始めるための重要なステップ:

context

  • ツールのインストール: Node.js, npm, Git、そして code エディターのような VS Code.
  • Set Up Capacitor: Capacitor と CLI をインストールし、プロジェクトを初期化する
  • プラットフォームの設定: iOSとAndroidのサポートを追加し、設定を調整し、codeを同期する
  • テストとデプロイ: デバイスでビルドし、live updateツールを使用し、 Capgo コンテキスト: HTMLテキストのフラグメント (親キー `submitting_a_pr_to_capgo`). ページ/エリア: Capgoマーケティングウェブサイト。ロール: ウェブサイトコピー。見つかった場所: contributing.astroページ。Capgo製品/ブランド名と開発者用語をそのまま保持する。メッセージキー `submitting_a_pr_to_capgo` (Capgoにプルリクエストを提出する)。

Capacitorは、ウェブアプリとネイティブデバイス機能を繋ぎ合わせ、プラットフォームを問わず滑らかなパフォーマンスを実現します。アプリ開発プロセスを簡素化するためのガイドに従ってください。

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

CAPACITOR

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

ここでは、開発環境を設定するための基本的なツールについて説明します。

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

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

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

以下の手順に従ってインストールしてください:

Once these are installed, you’re ready to move on to setting up the Capacitor CLI.

Capacitor CLI セットアップ

Get the Capacitor CLI up and running with these steps:

  1. Install Capacitor CLI globally

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

    npm install -g @capacitor/cli
  2. Capgo プラグインを初期化してください。

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

    npx @capgo/cli init

    __CAPGO_KEEP_0__ プラグインの設定を構成するために必要な設定を 更新管理を 効果的に [1]。アプリをビルド、テスト、デプロイするプロセスを簡素化します。

Capacitor プロジェクトの新規作成

Capacitor ツールをインストールした後、最初の Capacitor プロジェクトを設定する準備ができました。ここでは、プロジェクトを開始する方法を紹介します。

プロジェクトの作成

新しい Capacitor プロジェクトを作成するには、ターミナルを開いて以下のコマンドを実行してください。

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

例えば:

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

各パラメータの意味は次のとおりです:

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

このコマンドを実行した後、プロジェクト設定を capacitor.config.json file.

capacitor.config.jsonの設定

The capacitor.config.json ファイル

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

ここでは、重要なオプションの詳細を説明します。

設定 目的 例
appId アプリの固有識別子 com.example.app
appName アプリの表示名 My Capacitor App
webDir ビルド出力のディレクトリ dist
bundledWebRuntime Capacitor ランタイムを含めるか false
サーバーホストネーム 開発サーバーのホストネーム app.example.com
サーバー.アンドロイドスキーム アンドロイド用のURLスキーム https
サーバー.iosスキーム iOS用のURLスキーム https

依存関係のインストール

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

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

これらのステップを完了すると、プラットフォーム固有の設定と開発用にプロジェクトは準備が整いました。

モバイルプラットフォームの設定

Capacitorプロジェクトを初期化した後、次のステップはiOSとアンドロイドプラットフォームを追加して設定し、モバイルデバイスでネイティブにアプリを実行できるようにすることです。

iOSとアンドロイドの設定

はじめに、以下のコマンドを使用してプラットフォームのサポートを追加してください。

npx cap add ios
npx cap add android

プラットフォームを追加した後、Web code を以下のコマンドで同期してください。

npx cap sync

コマンドを実行する前に、Web アプリケーションがビルドされていることを確認し、 webDir in capacitor.config.json プラットフォーム固有の設定

iOS

iOS

次に、以下の設定を構成してください。

npx cap open ios

バンドル識別子

  • : アプリID と一致するようにしてください。開発チーム
  • Start by adding platform support using the following commands:の日本語訳は「はじめに、以下のコマンドを使用してプラットフォームのサポートを追加してください。」です。: code に適切なチームを割り当てます。
  • Deployment Target: 最小の iOS バージョンを設定します。
  • デバイスの向き: 必要に応じて調整します。
  • プライバシー説明: 必要な説明を追加します。 Info.plist.

Android

: Android プロジェクトを開きます。

npx cap open android

次に、これらの設定を更新してください。

  • : 以下の設定を更新します。Package Name
  • 許可: 必要な許可を定義する AndroidManifest.xml.
  • 画面の向き: この設定を行う AndroidManifest.xml.
  • ターゲット SDK: 適切なバージョンを設定する android/app/build.gradle.

アセットと設定の場所

ここでは、App アイコン、スプラッシュ画面、デープリンク、許可などの重要なファイルを見つけることができます。

設定 iOS の場所 Android の場所
App アイコン ios/App/App/Assets.xcassets android/app/src/main/res
Splash Screens ios/App/App/Assets.xcassets android/app/src/main/res
Deep Links ios/App/App/Info.plist AndroidManifest.xml
Permissions Info.plist AndroidManifest.xml

これらの設定を完了すると、モバイルデバイスでアプリをビルドおよびテストする準備が整います。

ビルドとテスト

前述の設定を使用して、現在はビルドおよびテストすることができます。 Capacitorアプリ context

Page/area: Capgo solutions marketing page. Role: Short UI label or navigation item. Seen in: page solutions/white-label.astro. Preserve Capgo product/brand and developer terms exactly. Message key `solutions_white_label_visual_cell1_value` (Solutions White Label Visual Cell1 Value).

さまざまなデバイスで正しく動作することを確認するために。

npm run build
npx cap sync

Build and Run Commands

iOS の場合

npx cap run ios

Android用:

npx cap run android

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

Capacitor プラグイン

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

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

インストール後、ネイティブプロジェクトでプラグインを設定します。設定要件の概要は以下のとおりです。

プラグイン iOS設定 Android設定
カメラ 追加 プライバシー説明 許可をマニフェストに追加
位置情報 位置情報の使用説明を追加 位置情報の許可を追加
ストレージ 保護されたトークン: Capacitor 保護されたトークン: Capacitor

追加設定は必要ありません Capgo

Capgo Live Update ダッシュボード インターフェイス

live update Capgo ダッシュボード インターフェイス [1].

アプリのデプロイメントとテストを簡素化するために、Capgoツールを__CAPGO_KEEP_1__に統合することができます。このサービスは、既に23.5百万回の更新を実行し、24時間以内に更新を受け取るユーザーは95%、グローバルでの成功率は82%を達成しています。

npm install @capgo/capacitor-updater
npx cap sync

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

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

Capgoは、エンドツーヘンド暗号化を使用して安全な更新配信を保証します。チャンネルシステムは、選択したユーザーグループと共に更新をテストし、全員にロールアウトする前に行うことを可能にします。

概要

このガイドは、Capacitorアプリの設定アップおよび展開のすべての段階を歩きました。必要なすべてのステップをカバーして、順調な運用を確保するために始めることができます。

主なポイント

Capacitorアプリの作成には、セットアップ、構成、およびプラットフォーム固有の調整に注意を払うことが必要です。開発環境のセットアップ - 例えば、 Node.js と Capacitor CLI - はアプリの起動に不可欠なステップです。iOSやAndroidなどのプラットフォームを設定することで、ネイティブシステム上でアプリが平滑に動作することを保証できます。

__CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__ [1].

__CAPGO_KEEP_0__

Phase Phase Steps
Tips Install tools, CLI setup ツールをインストールし、__CAPGO_KEEP_0__の設定を行う
設定 プラットフォームの設定を調整し、プラグインを追加 プラットフォーム固有のガイドラインに従う
テスト デバイス上でビルドしてテスト 実機でのテストを優先する
デプロイ 更新管理やバージョン管理 自動化されたパイプラインを使用して効率化

続きます: Capacitor アプリ初期化: ステップバイステップガイド

Capacitor アプリの初期化: ステップバイステップガイドを使用している場合 Capacitor アプリケーション初期化: ステップバイステップガイド CI/CD自動化を計画するには、を接続する必要があります。 Capgo CI/CD 製品ワークフローにおけるCapgo CI/CDのために Capgoネイティブビルド 製品ワークフローにおけるCapgoネイティブビルドのために Capgo統合 Capacitorアプリの初期化のステップバイステップガイドのために製品ワークフロー内でCapgo統合のために 製品ワークフローにおける__CAPGO_KEEP_0__統合のために CI/CD統合 GitHub アクション統合 Capacitorアプリの実装詳細についてはGitHubアクションの統合を参照してください。

Capacitor アプリの即時更新

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

マーティンから人間のサポート

今すぐ始めましょう

最新のブログ記事

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