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

VueとCapacitorによるモバイルアプリ開発

VueとCapacitorを使ってモバイルアプリを作成する方法を学び、必要に応じてCapgoのNative Navigation、Transitions、iOSレイアウトのベストプラクティスを活用してアプリを強化する方法も学びます。

VueとCapacitor Capgoでモバイルアプリを構築する ブログイラスト

本チュートリアルでは、Capacitorを使用してVueのWebアプリケーションをネイティブモバイルアプリに変換する手順を説明します。ネイティブなモバイル体験のためにCapgoのネイティブナビゲーションとトランジションを追加し、セーフエリアにはtailwind-capacitorを使用できます。

Capacitor について

Capacitorは、Webプロジェクトに簡単に統合し、アプリケーションをネイティブモバイルアプリに変換できるゲームチェンジャーです。XcodeとAndroid Studioのネイティブプロジェクトを生成し、JavaScriptブリッジを通じてカメラなどのネイティブデバイス機能へのアクセスを提供します。

Vueアプリの準備

まず、次のコマンドを実行して新しい Vue アプリを作成します:

vue create my-app
cd my-app
npm install

Vue アプリをネイティブモバイル展開用に準備するには、プロジェクトをエクスポートする必要があります。 package.json ファイルに、Vue プロジェクトをビルドしてコピーするスクリプトを追加します:

{
  "scripts": {
    // ...
    "build": "vue-cli-service build"
  }
}

この build コマンドを実行すると、プロジェクトのルートディレクトリに新しい dist フォルダが表示されるはずです。このフォルダは後で Capacitor で使用されます。

VueアプリにCapacitorを追加する

Vue ウェブアプリをネイティブモバイルコンテナに変換するには、以下の手順に従ってください:

  1. Capacitor CLI を開発用依存関係としてインストールし、プロジェクト内でセットアップします。セットアップ時は name と bundle ID をデフォルト値のままにしてください。

  2. コアパッケージと、iOS および Android プラットフォーム用の関連パッケージをインストールします。

  3. プラットフォームを追加すると、Capacitor がプロジェクトのルートに各プラットフォーム用のフォルダを作成します:

# Install the Capacitor CLI locally
npm install -D @capacitor/cli

# Initialize Capacitor in your Vue project
npx cap init

# Install the required packages
npm install @capacitor/core @capacitor/ios @capacitor/android

# Add the native platforms
npx cap add ios
npx cap add android

次に、Vueプロジェクトに新しい iOSと と Android フォルダが表示されるはずです。

更新: capacitor.config.json ファイルを指す webDir ビルドコマンドの結果に設定します:

{
  "appId": "com.example.app",
  "appName": "my-app",
  "webDir": "dist"
}

これで、VueプロジェクトをビルドしてCapacitorに同期できます:

npm run build
npx cap sync

ネイティブアプリのビルドとデプロイ

iOSアプリの開発にはXcode、Androidアプリの開発にはAndroid Studioのインストールが必要です。また、アプリストアへの公開には、iOSの場合はApple Developer Programへの登録、Androidの場合はGoogle Play Consoleへの登録が必要です。

Capacitor CLIを使用して、ネイティブプロジェクトの両方を開きます:

npx cap open ios
npx cap open android

Android StudioまたはXcodeを使用して、アプリを接続されたデバイスにデプロイします。

Capacitor Live Reload

Capacitorアプリがネットワーク上の特定のURLからコンテンツを読み込むようにすることで、モバイルデバイスでライブリロードを有効にします。

ローカルIPアドレスを確認し、 capacitor.config.ts ファイルに正しいIPアドレスとポートを設定します:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'my-app',
  webDir: 'dist',
  bundledWebRuntime: false,
  server: {
    url: 'http://192.168.x.xx:8080',
    cleartext: true
  }
};

export default config;

これらの変更をネイティブプロジェクトにコピーして適用します:

npx cap copy

これで、Vue アプリを更新すると、アプリが自動的にリロードされて変更が反映されます。

Capacitor プラグインの使用

Share プラグインなどの Capacitor プラグインをインストールし、Vue アプリで使用します:

npm i @capacitor/share

パッケージをインポートし、 share() 関数をアプリ内で呼び出します:

<template>
  <div>
    <h1>Welcome to Vue and Capacitor!</h1>
    <button @click="share">Share now!</button>
  </div>
</template>

<script setup lang="ts">
import { Share } from '@capacitor/share';

async function share() {
  await Share.share({
    title: 'Open Youtube',
    text: 'Check new video on youtube',
    url: 'https://www.youtube.com',
    dialogTitle: 'Share with friends'
  });
}
</script>

新しいプラグインをインストールした後、 sync コマンドを実行して、アプリをデバイスに再デプロイします:

npx cap sync

次に、Capgo のナビゲーションとトランジションで、iOS と Android でアプリをよりネイティブに感じさせ、横方向のオーバーフローやセーフエリアの欠けを引き起こす iOS でよくあるレイアウト問題も修正できます。

Capgo Native Navigation and Transitions によるネイティブ感のあるUI

私は長年、 Ionic クロスプラットフォームアプリの構築には適していますが、すでに代替手段がある場合、Vueとの統合はハック的で、ほとんど価値がありません Tailwind CSS がある場合は、あまりメリットがありません。.

Vue + Capacitor アプリでネイティブなモバイル体験を実現するには、Konsta UIのようなWeb専用UIキットではなく、Capgo プラグインを使用してください:

  • @capgo/capacitor-native-navigation — ネイティブなナビゲーションバー、iOSのLiquid Glassタブバー、Androidのブラー付きタブバースタイル。Vueルーターはルート状態を管理し、プラグインがネイティブUIを制御します。
  • @capgo/capacitor-transitions — Ionic UIを採用せずに、WebViewレイヤーでIonicスタイルのページ遷移とiOSのエッジスワイプによる戻る操作を実現します。

両方をインストールしてください:

bun add @capgo/capacitor-native-navigation @capgo/capacitor-transitions
bunx cap sync

CSS insetモードでネイティブナビゲーションを設定し、Webコンテンツがネイティブバーと重ならないようにします:

import { NativeNavigation } from '@capgo/capacitor-native-navigation';

await NativeNavigation.configure({
  contentInsetMode: 'css',
  animationDuration: 360,
  glass: {
    effect: 'liquidGlass',
  },
});

Liquid Glassタブバーをレンダリングします(iOSはシステム側のレンダリングを使用し、Androidはぼかし付きWebViewバックドロップを使用します):

await NativeNavigation.setTabbar({
  selectedId: 'home',
  labelVisibilityMode: 'labeled',
  icons: true,
  colors: { dynamic: true },
  tabs: [
    { id: 'home', title: 'Home', icon: { svg: '...' } },
    { id: 'settings', title: 'Settings', icon: { svg: '...' } },
  ],
});

await NativeNavigation.addListener('tabSelect', ({ id }) => {
  router.push(`/${id}`);
});

アプリシェルにネイティブページ遷移を追加します:

<script setup>
import { ref, onMounted } from 'vue';
import { useRouter } from 'vue-router';
import '@capgo/capacitor-transitions';
import { initTransitions, setDirection, setupRouterOutlet } from '@capgo/capacitor-transitions/vue';

initTransitions({ platform: 'auto' });

const router = useRouter();
const outletRef = ref(null);

onMounted(() => {
  if (outletRef.value) {
    setupRouterOutlet(outletRef.value, { platform: 'auto', swipeGesture: 'auto' });
  }
});

const openSettings = () => {
  setDirection('forward');
  router.push('/settings');
};
</script>

<template>
  <cap-router-outlet ref="outletRef">
    <router-view />
  </cap-router-outlet>
</template>

ルーティングされたページを以下でラップします: cap-router-outlet, cap-pageや cap-content、そして呼び出します setDirection('forward') または setDirection('back') 遷移前に実行してください。ネイティブナビゲーションがその領域を管理している場合、Webのヘッダーやフッターを重複させないでください。

ガイドの全文はこちら: @capgo/capacitor-native-navigation の活用 と @capgo/capacitor-transitions の活用.

Tailwind によるセーフエリア対応

Tailwind CSS でデバイスのセーフエリアを扱うには、以下を使用します: @capgo/tailwind-capacitor ( tailwind-capacitor として npm で公開)。これは、 safe-areas ユーティリティや Capacitor と相性の良いその他の Tailwind プラグインを提供します:

bun add -D tailwind-capacitor

では src/assets/main.css:

@import 'tailwindcss';
@plugin "@capgo/tailwind-capacitor/platform";
@plugin "@capgo/tailwind-capacitor/safe-areas";

次のようなユーティリティを使用します: pt-safe, pb-safeや px-safe 手作業でばらまくのではなく env(safe-area-inset-*) 手動で行います。プロジェクトは活発に開発されており、Vue のセットアップに必要なものが不足している場合は、 GitHub でPRを作成してください.

iOSのレイアウト問題を修正(ビューポート、セーフエリア、横方向のオーバーフロー)

iOSでコンテンツが切れて見えたり、ずれて見えたり、横スクロールが発生したりする場合は、さらに追加するだけでも、 overflow-x: hidden viewportタグを調整するだけでも通常は解決しません。以下のチェックを順番に確認してください。

viewport メタタグが正しく適用されているか確認する

に viewport メタタグを追加します index.html 既存の <head>:

<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />

iOSのセーフエリアは1つのルートラッパーだけで処理する

単一のアプリシェルを作成し、そこにセーフエリアのパディングを適用してください — 複数のネストしたコンポーネントではなく:

html,
body,
#app {
  width: 100%;
  min-height: 100%;
  margin: 0;
  padding: 0;
  overflow-x: hidden;
}

* {
  box-sizing: border-box;
}

.app-shell {
  min-height: 100dvh;
  width: 100%;
  padding-top: env(safe-area-inset-top);
  padding-right: env(safe-area-inset-right);
  padding-bottom: env(safe-area-inset-bottom);
  padding-left: env(safe-area-inset-left);
}

すべてのページコンテンツを以下でラップします: .app-shellヘッダー、モーダル、レイアウトラッパーで safe-area のパディングが重複すると、UI が欠けたり、逆に大きすぎたりすることがよくあります。

を使用すると、 @capgo/tailwind-capacitor同じパディングを次のようなユーティリティで表現できます: pt-safe pb-safe px-safe その単一のシェル上で。

Capacitor iOS を設定 contentInset まで never 最初に

では capacitor.config.ts、native inset を無効にすることを推奨し、CSS(または Native Navigation のもの contentInsetMode: 'css')に safe area を任せる:

const config: CapacitorConfig = {
  appId: 'com.example.myapp',
  appName: 'my-app',
  webDir: 'dist',
  ios: {
    contentInset: 'never',
  },
};

Capacitor の自動コンテンツ inset と CSS を混在させると env(safe-area-inset-*) padding は二重スペースのよくある原因です。

実際にオーバーフローしている要素を特定する

原因はたいてい、使用している要素です 100vw、Tailwind w-screen、固定ピクセル幅、または大きな min-width.

Safari Web Inspectorで以下を実行してください:

[...document.querySelectorAll('*')]
  .filter(el => el.scrollWidth > document.documentElement.clientWidth)
  .map(el => ({
    el,
    tag: el.tagName,
    class: el.className,
    scrollWidth: el.scrollWidth,
    clientWidth: document.documentElement.clientWidth,
  }));

Tailwindを使用する場合は、可能な限り w-screen を使用して w-full 置き換えてください。水平方向のオーバーフロー問題の多くは 100vw / w-screen、重複したセーフエリアのパディング、または固定幅のコンテナに起因し、viewportのmetaタグ自体が原因ではありません。

まとめ

Capacitor は、既存のWebプロジェクトをベースにネイティブアプリを構築するための優れた選択肢です。Capgo を追加することで、アプリにライブアップデートを簡単に実装でき、ユーザーが常に最新機能やバグ修正を利用できるようになります。

Capgo が、より良いアプリをより速く作るのにどう役立つかをご覧ください。 無料アカウントに登録する を今すぐ作成してください。

VueとCapacitorでのモバイルアプリ構築を続ける

使用している場合 VueとCapacitorによるモバイルアプリ開発 ネイティブメディアとインターフェースの挙動を計画するには、次と連携させてください @capgo/capacitor-live-activities の使用 @capgo/capacitor-live-activities の使用におけるネイティブ機能については、 @capgo/capacitor-live-activities @capgo/capacitor-live-activities の実装の詳細については、 @capgo/capacitor-video-playerの使用方法 @capgo/capacitor-video-player の使い方におけるネイティブ機能については、 @capgo/capacitor-video-player @capgo/capacitor-video-player の実装の詳細、および @capgo/capacitor-native-navigation の活用 @capgo/capacitor-native-navigation. の使い方におけるネイティブ機能については

Capacitor アプリ向けの Live Updates

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

最新のブログ記事

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