Cobble源码构建教程iOS与Android平台从零安装的完整步骤【免费下载链接】mobile-appCobble: Rebble device companion app for iOS and Android项目地址: https://gitcode.com/gh_mirrors/mobi/mobile-appCobble 是 Rebble 项目为 Pebble / RebbleOS 智能手表打造的官方伴侣应用同时支持iOS 与 Android两大平台。本篇文章是一份面向新手的Cobble 源码构建教程从环境准备、源码获取到最终编译出可安装的 App带你一步步完成Cobble 编译安装全程无需深入代码细节照着操作即可成功。Cobble 是什么为什么要自己编译Cobble 的核心功能是让手机与 Pebble/RebbleOS 手表保持连接负责消息通知同步、应用安装、表盘管理、健康数据与时间线等日常操作。它基于Flutter Kotlin Multiplatform Swift混合开发主体界面由 Flutter 编写lib/目录Android 原生层使用 Kotlinandroid/目录iOS 原生层使用 Swiftios/目录。自己动手编译的好处也很明显可以体验最新特性、定制自己的功能或者在官方商店没有上架的地区自行安装。整个项目用到的关键依赖集中在 pubspec.yaml 中Android 端版本号统一由android/gradle/libs.versions.toml管理iOS 的依赖则由ios/Podfile声明非常规范。构建前的环境准备清单在开始之前请先确认电脑上已经装好了以下工具这是Cobble 编译环境的必备项工具版本要求用途Flutter3.7.12精确锁定跨平台 UI 框架Dart SDK 2.19.0随 Flutter 自带JDK17 及以上编译 Android 代码Android SDKAPI 29 ~ 35构建 Android 应用Xcode12构建 iOS 应用仅 macOSCocoaPods最新版iOS 依赖管理小技巧项目对 Flutter 版本有严格要求官方推荐使用FVMFlutter Version Management来锁定版本避免在我电脑上明明能编译的尴尬。第一步获取 Cobble 源码首先把项目源码克隆到本地。在终端执行git clone https://gitcode.com/gh_mirrors/mobi/mobile-app克隆完成后进入项目目录并拉取项目依赖的Git 子模块cd mobile-app git submodule update --init --recursive子模块中包含蓝牙传输层等底层组件对应android/pebble_bt_transport、android/pebblekit_android、android/shared、android/speex_codec等模块这一步不能跳过否则编译时会报找不到模块的错误。第二步配置 GitHub Token关键步骤Cobble 的 Android 构建依赖一个名为libpebblecommon的私有依赖包它托管在 GitHub Packages 上因此需要你准备一个GitHub 个人访问令牌Token并授予read:packages权限。拿到 Token 后在android目录下新建一个local.properties文件写入以下内容GITHUB_ACTOR你的 GitHub 用户名 GITHUB_TOKEN你生成的 Token这个文件是 Gradle 读取凭据的地方请勿提交到版本库。配置完成后Android 端就能顺利拉取到加密依赖包了。第三步安装 Flutter 并同步依赖推荐使用 FVM 安装项目锁定的 Flutter 版本。在项目根目录执行fvm install等待 FVM 自动下载对应的 Flutter 3.7.12 后继续同步 Dart 依赖fvm flutter pub get这一步会根据pubspec.yaml拉取所有第三方库。如果你后续修改了数据模型还可以通过以下命令重新生成代码映射普通用户可跳过fvm flutter pub run build_runner build --delete-conflicting-outputs第四步编译 Android 版 AppAndroid 端编译最简单只要环境齐全一条命令就能跑起来fvm flutter run命令会自动调用 Gradle构建配置见android/build.gradle.kts与android/settings.gradle编译并安装到已连接的设备或模拟器上。如果想直接产出 APK 安装包可以改用fvm flutter build apk --release构建产物默认输出在build/app/outputs/flutter-apk/目录拷到手机即可安装。Android 工程对系统要求不高最低支持 Android 10minSdk 29目标版本为 Android 15targetSdk 35覆盖了绝大多数在役机型。第五步编译 iOS 版 AppiOS 编译需要 macOS 环境先安装 CocoaPodsbrew install ruby sudo gem install cocoapods然后在项目根目录执行构建命令fvm flutter build iosflutter build ios会自动运行pod install安装 iOS 依赖之后就可以用 Xcode 打开ios/Runner.xcworkspace进行签名与真机部署了。iOS 的最低部署版本是 12.0配置见ios/Podfile。 如果只是想在 iOS 模拟器上快速体验可以跳过签名fvm flutter run -d ios常见问题与排错技巧报错找不到 libpebblecommon多半是local.properties没配好或者 Token 缺少read:packages权限重新检查第二步。Flutter 版本不匹配务必使用 FVM 安装的 3.7.12直接在pubspec.yaml中也能核对锁定版本。Android 编译卡在下载依赖国内网络可尝试为 Gradle 配置镜像仓库修改android/settings.gradle中的仓库地址。iOS 构建很慢首次会编译全部 Pods属正常现象建议关闭 CocoaPods 统计上报加快速度ios/Podfile已默认关闭。结语一次编译双端通用按照这份Cobble 源码构建教程从克隆仓库到生成安装包全程只需五步获取源码 → 配置 Token → 安装 Flutter → 编译 Android → 编译 iOS。无论是想自己刷机使用还是想深入学习手表伴侣应用的架构可重点阅读lib/的 Flutter UI、android/的蓝牙桥接、ios/的 Swift 原生层这份完整步骤都能帮你快速上手。遇到问题就对照上面的排错清单祝你编译顺利【免费下载链接】mobile-appCobble: Rebble device companion app for iOS and Android项目地址: https://gitcode.com/gh_mirrors/mobi/mobile-app创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考