進化し続けるモバイルアプリ開発の世界において、Progressive Web Applications(PWA)の台頭は、新たなクロスプラットフォームランタイムへの道を切り拓きました。これらのランタイムにより、Webベースのアプリケーションは native code だけに頼ることなくアプリストアに展開できます。これを可能にする技術の一つが CapacitorJSであり、単一のJavaScriptコードベースでAndroid、iOS、Web向けにシンプルなWebサイトをアプリとしてデプロイできます。このアプローチにより開発コストを大幅に削減し、コーディング効率を高められます。
本ガイドでは、追加のフレームワークなしで純粋なJavaScriptを使ってアプリを作成する方法に焦点を当てます。2021年当時、純粋なJavaScriptでのアプリ開発リソースを見つけるのは難しい状況でしたが、CapacitorJSでアプリを構築し、ネイティブプラグインを活用するための包括的なチュートリアルを提供します。
‣ 前提条件
始める前に、以下のツールがインストールされていることを確認してください:
- Node.js (v14.16.1) 以上
- NPM (v7.6.2) 以上
- デバッグ Android アプリ開発用
- iOSプロファイリング iOS アプリ開発用 (macOS のみ)
注意: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
- 次の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>
-
以下の
<capacitor-welcome>HTML要素をbodyから削除してください。 -
スクリプトのimport元を
capacitor.jsまでjs/main.jsに更新します。これがbundleされたJavaScriptファイルになります。 -
以下の
js/capacitor-welcome.jsimportを削除します。これで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 のプロダクトワークフローについては、