用途
Ionic + Vue 应用开发指导(SKILL 文件)。用于构建生产可用的 Ionic Capacitor 移动应用,技术栈为 Vue 3 Composition API、@ionic/vue-router 与 vue-i18n。
定位说明
这是 SKILL 文件,不是项目。不要在此处运行 npm install。创建新项目时,应询问项目路径,或在独立目录中搭建(例如 ~/Projects/<app>)。
参考文档目录
项目搭建相关:
- 创建新的 Vue Ionic 项目:new-app.md
- 项目结构:project-structure.md
- 应用配置(main.ts、App.vue):app-config.md
- 路由(@ionic/vue-router + beforeEach 守卫):routing.md
页面与导航相关:
- 引导守卫(router beforeEach):onboarding-guard.md
- 引导页(视频背景 + Swiper):onboarding-page.md
- 付费墙页(RevenueCat):paywall-page.md
- 标签布局(含横幅广告生命周期):tabs-navigation.md
- 设置页:settings-page.md
横切关注点相关:
- 组合式函数(主题 / 引导 / 广告 / 购买 / 通知):composables.md
- 使用 vue-i18n 进行国际化:i18n-vue-i18n.md
- 最佳实践(Composition API + <ion-page>):best-practices.md
- 命令(build / sync / open):commands.md
原生插件主题位于 ../ionic-shared/references/:
- admob.md
- revenuecat.md
- push-notifications.md
- storage.md
- theming.md
- localization-content.md
必需页面(始终创建)
- 引导页:基于滑动,全屏背景视频 + 渐变遮罩。
- 付费墙:RevenueCat(周 / 年),在引导结束后立即展示。
- 设置页:语言、主题、通知、移除广告、重置引导。
必需导航
使用 ion-tabs + ion-tab-bar。绝不要自行构建自定义标签栏,也不要引入第三方标签库。
必需依赖库
npm install
@capacitor/preferences @capacitor/push-notifications
@capacitor/splash-screen @capacitor/status-bar
@revenuecat/purchases-capacitor @capacitor-community/admob
vue-i18n
swiper
硬性规则(Vue 专属)
- 禁止:新代码使用 Options API,应使用 Composition API 与 <script setup lang="ts">。
- 禁止:直接操作 DOM,应使用 refs / 响应式。
- 禁止:从 @ionic/angular 或 @ionic/react 导入,仅可使用 @ionic/vue。
- 禁止:使用 any 类型。
- 要求:每个页面都用 <ion-page> 包裹,以保证 Ionic 的转场与生命周期正常工作。
完成前检查
- npm install
- npm run build
- npx cap sync
构建必须无错误完成。每次 Web 构建之后、在原生端测试之前,都需要执行 cap sync。
限制
以上为资料提供的全部内容;未提及具体的版本号、授权方式、收费与价格信息,暂未提供。