SuperAPI AI 工具集

ionic-vue

编程与开发

查看项目

更新于 10-16 14:56

技能介绍

用途

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。

限制

以上为资料提供的全部内容;未提及具体的版本号、授权方式、收费与价格信息,暂未提供。