💖 夸他 APP (Kuata App)

一个使用 React Native + Expo 开发的趣味夸赞 App，旨在让每一句夸奖都充满仪式感。通过打字机效果生成走心的赞美文案，配合炫酷的粒子特效和精美的荣誉证书，让被夸的人心花怒放！

✨ 核心功能

• 📝 智能赞美生成

  • 输入姓名和优点关键词，自动生成 30-50 字的专业/趣味赞美文案。
  • 支持 打字机动画 逐字显示，营造期待感。
  • 高亮显示 名字和关键词，重点突出。

• 🎉 沉浸式互动特效

  • 连击点赞：红色爱心按钮，右上角实时显示点赞数（支持 99+ 显示）。
  • 粒子爆炸：每次点赞触发高性能彩色纸屑特效（烟花式喷发）。
  • 动态反馈：连击超过 10 次触发界面抖动特效，氛围感拉满。

• 🏆 荣誉证书颁发

  • 精美设计：金色渐变背景 + 麦穗装饰 + 官方印章，轻奢风格。
  • 弹窗展示：沉浸式 Modal 弹窗预览证书。
  • 双重保存：
    • 分享：调用系统分享面板，发送给微信/QQ好友。
    • 下载：直接保存高清证书图片到手机相册（已适配 Android 13+ 权限）。

📱 界面预览

界面采用鲜艳的紫-蓝-粉渐变风格，布局紧凑，所有核心交互均在单屏内完成，无需繁琐滚动。

🚀 快速体验 (评测人员)

如果您是评测人员，无需配置任何开发环境，只需安装我们提供的 APK 文件即可直接体验：

1. 获取 APK 文件

   • 请在提交附件中找到 kuata_app_v1.apk
   • 或者直接使用提供的下载链接 https://expo.dev/artifacts/eas/ucpzkScodzuUJyHu2kK2GP.apk

2. 安装到手机

   • 将 APK 文件传输到您的 Android 手机。
   • 点击安装（如果提示“未知来源”，请允许安装）。
   • 安装完成后点击图标即可打开 App。

3. 开始体验

   • 输入姓名和优点，点击生成。
   • 体验打字机效果、连击点赞特效和证书保存功能。

---

👨‍💻 开发者指南 (源码运行)

如果您希望查看源码或进行二次开发，请按照以下步骤操作：

前置要求

1. Node.js (建议 v18+)
2. Expo Go App (在手机应用商店搜索下载)

安装与运行

1. 克隆/下载项目

   git clone https://github.com/ykj467422034/Kuata_app_Android.git
   cd Kuata_app_Android

2. 安装依赖

   npm install

3. 启动开发服务器

   npm start

   注：默认配置端口为 19000

4. 真机预览

   • 打开手机上的 Expo Go App。
   • 扫描终端显示的二维码。
   • 确保手机和电脑连接在同一 WiFi 网络下。

🛠 技术栈

• 核心框架: React Native + Expo (Managed Workflow)
• 语言: TypeScript
• UI 组件: Custom Components + @expo/vector-icons
• 动画与特效:
  • react-native-reanimated (高性能动画)
  • react-native-confetti-cannon (粒子特效，单实例优化)
• 功能库:
  • react-native-view-shot (视图截图)
  • expo-sharing (系统分享)
  • expo-media-library (相册存取)
  • expo-linear-gradient (渐变背景)

📁 项目结构

Kuala_app_Android/
├── App.tsx                      # 主入口 (布局与状态管理)
├── app.json                     # Expo 全局配置
├── eas.json                     # EAS 打包配置
├── src/
│   ├── components/
│   │   ├── InputForm.tsx        # 输入表单组件
│   │   ├── PraiseDisplay.tsx    # 赞美文案显示 (含打字机逻辑)
│   │   ├── LikeButton.tsx       # 点赞按钮 (含粒子与抖动特效)
│   │   └── Certificate.tsx      # 荣誉证书 (含弹窗与保存逻辑)
│   ├── hooks/
│   │   └── useTypewriter.ts     # 自定义 Hook: 打字机效果
│   └── utils/
│       └── mockPraise.ts        # 文案生成逻辑 (含18种风格模板)
└── assets/                      # 静态资源

📦 打包 APK (Android)

本项目已配置 EAS Build，可直接打包为 APK 文件分发：

1. 安装 EAS CLI

   npm install -g eas-cli

2. 登录 Expo

   npx eas login

3. 构建 APK

   eas build -p android --profile preview

   构建完成后，终端会生成一个下载链接，可直接下载安装。

🐛 常见问题

• Q: 保存证书时提示权限错误？

  • A: 最新版本已修复此问题。我们使用 writeOnly: true 模式请求权限，仅需写入权限即可，不再触发布 Android 13+ 的音频权限检查。

• Q: 纸屑特效卡顿？

  • A: 请确保使用的是最新代码。我们优化了粒子系统，使用单实例 Ref 控制和 InteractionManager，即使快速连击也能保持 60fps 流畅度。

📝 更新日志

• v1.4.3: 修复 Android 13+ 下载权限问题。
• v1.4.2: 新增“分享”与“下载”双按钮模式。
• v1.4.0: 重构保存方案，引入 expo-sharing。
• v1.3.8: 粒子特效终极优化（无卡顿、无 Key 冲突）。
• v1.3.0: UI 全面升级，引入专业证书设计。

---

Enjoy! 🎉 让每一次夸奖都充满仪式感！