本チュートリアルでは、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 ウェブアプリをネイティブモバイルコンテナに変換するには、以下の手順に従ってください:
-
Capacitor CLI を開発用依存関係としてインストールし、プロジェクト内でセットアップします。セットアップ時は name と bundle ID をデフォルト値のままにしてください。
-
コアパッケージと、iOS および Android プラットフォーム用の関連パッケージをインストールします。
-
プラットフォームを追加すると、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. の使い方におけるネイティブ機能については