独立开发记录：我怎么把一个专注计时器做成了「声音护照」— iOS端技术拆解

为什么要做这个App去年我给自己定了个规矩每天至少专注写稿25分钟。试了一圈市面上的番茄钟发现都是同一个套路倒计时、叮一声、结束。用了两周就不想打开了。没有留存感没有成就感就是个闹钟。我想要的是——每次专注结束后能看到点什么东西。像打游戏一样有经验条在涨像跑步一样有公里数在累积。所以去年12月我上架了「声境护照」把专注计时包装成了一段段飞行旅程。现在版本 1.4说实话下载量很一般但这个项目本身让我学到了不少东西值得记录一下。数据模型把专注包装成「远征」我设计了一套叫 Expedition 的数据结构。每个章节对应一座城市也就是一个声景章节下面挂着几个任务structExpeditionChapterDefinition:Identifiable,Codable,Equatable{letid:StringletsceneId:StringletcityName:Stringlettagline:StringletbonusBounces:Intletmissions:[ExpeditionMissionDefinition]}structExpeditionMissionDefinition:Identifiable,Codable,Equatable{letid:Stringlettitle:Stringletkind:ExpeditionMissionKind// .sessionCount / .focusMinutes / .deepFocusCountlettargetValue:IntletrewardMiles:Int} 任务类型就三种累计专注次数、累计分钟数、深度专注次数。全部完成解锁下一座城市。这个结构看着简单但给用户的感知完全不一样——不是你今天专注了50分钟而是你在东京飞行了50公里解锁了雨夜任务。 实现成本其实不高每次 focusSession 结束时遍历一遍当前章节的 missionStates更新 progress 值判断是否触发 completedAt 就行了。 ## 统计和分享卡片花了三周才搞定 战报卡片是我花时间最多的部分。每次专注结束要生成一张好看的卡片包含时长、声景、效率指数、经验值增长。周末还有周回顾卡片画7天分布图。ViewModel层我写得很薄核心计算全部收在 StatsService 里 swiftvarstats:StatsData{StatsService.buildStatsData(focusLogs:logs,streakDays:store.streakDays,rangeKey:.d7,now:Date(),isDemo:store.focusLogs.isEmpty)} 这里有个取舍当用户 focusLogs 为空时我会塞 demo 数据进去。新用户打开统计页看到的不是空白而是示例卡片。这样他知道坚持几天后我也能得到这个。试了不放 demo 数据的版本新用户留存明显差一截。 卡片渲染这块踩了坑。一开始用SwiftUI直接转UIImage部分机型偶现空白图。后来改成先塞进UIHostingController、等布局完成再截图问题解决了但代码丑了不少。 ## 智能推荐下一次专注1.4版本加了一个功能专注结束后根据历史数据推荐下一次的时间和时长。 逻辑考虑三个因素今天日计划还差几段、当前连续天数、历史高频专注时段。连续天数不同提示文案不同——连续5天以上说重点是保持节奏刚开始的用户说先连续3天试试。 这些文案我改了好几版。最早写得太鸡汤被我自己嫌弃了太冷冰冰又没有推动力。最后的原则是只说事实和建议不说加油你可以的。 ## 灵动岛1.2版本接了ActivityKit做灵动岛显示。锁屏状态能看到剩余时间和当前声景名。ContentState里放了 endDate、phase、remainingSeconds、progress 这些字段。 这个功能实现不复杂主要注意更新频率别太高就行。对用户体验提升挺明显——不用解锁手机就能瞄一眼还剩多久。 ## 踩过的坑和一些数字 上架时间2024年12月。当前版本1.4。 说实话最近一周下载基本为零。独立开发没预算推广冷启动全靠搜索和口碑这事儿急不来。 几个教训-声景音频文件把包体撑到了 200MB后来改按需下载才降到 60MB--成长系统经验值公式改了三次。第一版两天就满级完全没有盼头。现在大概连续用两周到Lv.5--分享功能做得再花哨如果用户没养成打开App的习惯就没有分享的机会。所以通知策略比卡片设计更重要 ## 后续想法 在考虑做鸿蒙版本。ArkUI声明式写法和SwiftUI思路接近ViewModel逻辑迁移应该不难。音频后台播放和卡片服务对标LiveActivity这块还在研究HarmonyOS的文档。 如果你也在做 iOS 或者鸿蒙的工具类独立应用可以评论区聊聊互相参考一下踩坑经验。AppStore搜索「声境护照」能找到。