メインコンテンツへスキップ
チュートリアル

CapacitorJSによるクロスプラットフォームアプリ開発:ステップバイステップガイド

CapacitorJS を使って、単一の JavaScript コードベースで Android、iOS、Web (PWA) 向けのクロスプラットフォームアプリを作る方法を学びましょう。

『CapacitorJSでクロスプラットフォームアプリを開発する:ステップバイステップガイド』 Capgo ブログ用イラスト

進化し続けるモバイルアプリ開発の世界において、Progressive Web Applications(PWA)の台頭は、新たなクロスプラットフォームランタイムへの道を切り拓きました。これらのランタイムにより、Webベースのアプリケーションは native code だけに頼ることなくアプリストアに展開できます。これを可能にする技術の一つが CapacitorJSであり、単一のJavaScriptコードベースでAndroid、iOS、Web向けにシンプルなWebサイトをアプリとしてデプロイできます。このアプローチにより開発コストを大幅に削減し、コーディング効率を高められます。

本ガイドでは、追加のフレームワークなしで純粋なJavaScriptを使ってアプリを作成する方法に焦点を当てます。2021年当時、純粋なJavaScriptでのアプリ開発リソースを見つけるのは難しい状況でしたが、CapacitorJSでアプリを構築し、ネイティブプラグインを活用するための包括的なチュートリアルを提供します。

‣ 前提条件

始める前に、以下のツールがインストールされていることを確認してください:

注意:iOS アプリ開発は macOS デバイスでのみ可能です。

‣ Capacitor プロジェクトのセットアップ

Capacitor アプリを作成するには、対象のフォルダに移動し、ターミナルで以下のコマンドを実行します。

npm init @capacitor/app

プロンプトに従ってパッケージをインストールし、プロジェクトを設定してください。Capacitor v3 では、プロジェクトディレクトリは以下のようになります。

www/
  css/
    style.css
  js/
    capacitor-welcome.js
  index.html
  manifest.json
.gitignore
capacitor.config.json
package.json
README.md

初期設定が完了したので、次のステップに進めます。

‣ プロジェクトの再構成

JavaScript ファイルのバンドルには Vite を使用します。プロジェクト構造を以下のように再構成しましょう。

  • 作成します 新しいフォルダ src メインディレクトリに作成します。
  • 作成します 新しいスクリプトファイル index.js における src/.
  • 作成します Vite設定ファイル vite.config.js メインディレクトリに。
  • 削除 この capacitor-welcome.js から www/js/.

新しいフォルダ構造は次のようになります:

src/
  index.js
www/
  css/
    style.css
  js/
  index.html
  manifest.json
.gitignore
capacitor.config.json
package.json
README.md
vite.config.js

‣ 純粋なJavaScriptへの適応

純粋なJavaScriptで動くようにファイルを修正しましょう:

www/index.html

  1. 次のscriptインポートを削除します Ionic PWA Elements アプリをPWAとしてリリースしない場合:
<script type="module" src="https://unpkg.com/@ionic/pwa-elements@latest/dist/ionicpwaelements/ionicpwaelements.esm.js"></script>
<script nomodule src="https://unpkg.com/@ionic/pwa-elements@latest/dist/ionicpwaelements/ionicpwaelements.js"></script>
  1. 以下の <capacitor-welcome> HTML要素をbodyから削除してください。

  2. スクリプトのimport元を capacitor.js まで js/main.jsに更新します。これがbundleされたJavaScriptファイルになります。

  3. 以下の js/capacitor-welcome.js importを削除します。これで index.html の準備が完了しました。

vite.config.js

Node.jsモジュールを以下でbundleするには Viteを使用する場合、バンドルしたスクリプトの出力先を指定する設定ファイルが必要です。以下の設定により、ファイルを src/index.js 本番用にバンドルし、ファイル名は www/js/main.js:

import { defineConfig } from 'vite';
import path from 'node:path';

export default defineConfig({
  build: {
    outDir: path.resolve(__dirname, 'www'),
    rollupOptions: {
      input: './src/index.js',
      output: {
        format: 'es',
        file: path.resolve(__dirname, 'www/js/main.js')
      }
    }
  }
});

capacitor.config.json

では capacitor.config.json ファイルを開き、 "bundledWebRuntime": true プロパティを見つけて、次のように変更してください。 falseこれにより、Capacitor がファイルをバンドルしなくなり、代わりに Vite を使用できるようになります。

これらの変更で、Capacitor アプリケーションの基本セットアップは完了し、純粋な JavaScript でアプリ開発を始める準備が整いました。

‣ アプリの開発

土台が整ったので、次は src/index.js ファイルにアプリケーションロジックを書き始められます。ここでは、必要な Node.js モジュールをインポートし、アプリの機能を定義し、Capacitor のネイティブプラグインと連携できます。

変更を加えるたびに、JavaScriptファイルをバンドルするためにViteのbuildコマンドを実行することを忘れないでください:

vite build

このコマンドは以下を生成します main.js ファイルが参照する www/js ディレクトリ内の index.html ファイルを作成します。

‣ テストとデバッグ

Capacitor は、アプリケーションをさまざまなプラットフォームでテストするための便利な方法を提供します。以下のコマンドを使用して、アプリを各プラットフォームの開発環境で開きます:

Androidの場合:

npx cap add android
npx cap open android

iOS の場合 (macOS のみ):

npx cap add ios
npx cap open ios

Web/PWA の場合:

npx cap serve

これらのコマンドにより、Android Studio、Xcode、または Web ブラウザでアプリケーションを実行し、必要に応じてテストやデバッグを行うことができます。

‣ まとめ

純粋なJavaScriptでCapacitorJSを使ったクロスプラットフォームアプリ開発は、単一のコードベースで複数のプラットフォーム向けアプリを作れる、コスト効率が高く効率的な方法です。このガイドに沿って、プロジェクトのセットアップ、Vite向けの再構成、開発の準備が整いました。この基盤があれば、堅牢で汎用性の高いアプリケーションの構築に向けて順調に進められます。

すべてのプラットフォームで徹底的にテストし、Capacitorのネイティブプラグインを活用してアプリの機能を高めましょう。Happy coding!

「CapacitorJSによるクロスプラットフォームアプリ開発:ステップバイステップガイド」の続きを読む

使用している場合 CapacitorJSによるクロスプラットフォームアプリ開発:ステップバイステップガイド ネイティブプラグインの作業を計画するには、次と連携してください: Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新に関する実装詳細については、 Ionic Enterprise プラグインの代替案 Ionic Enterprise Plugin Alternatives のプロダクトワークフロー、および Capgo Native Build Capgo Native Builds のプロダクトワークフローについては、

Capacitor アプリ向けの Live Updates

Web レイヤーのバグが本番で発生したら、App Store の審査を何日も待たずに Capgo で修正を配信しましょう。ネイティブの変更は通常の審査フローに残したまま、ユーザーはバックグラウンドでアップデートを受け取れます。

最新のブログ記事

Capgoは、真にプロフェッショナルなモバイルアプリを作るために必要な最高のインサイトを提供します。