環(huán)境搭建與項目結構完整解析)
從零開始為Cobble貢獻代碼開發(fā)環(huán)境搭建與項目結構完整解析【免費下載鏈接】mobile-appCobble: Rebble device companion app for iOS and Android項目地址: https://gitcode.com/gh_mirrors/mobi/mobile-appCobble 是 Rebble 社區(qū)為 Pebble/RebbleOS 智能手表打造的開源伴侶應用覆蓋 iOS 與 Android 雙平臺代碼完全開放。本文為想給 Cobble 貢獻代碼的新手準備了一份開發(fā)環(huán)境搭建保姆級教程并帶你完整梳理項目結構理解 Flutter 與 Kotlin Multiplatform 混合架構的協(xié)作方式幫你用最短時間從「看得懂」到「改得動」邁出提交第一個 Pull Request 的第一步。為什么值得為 Cobble 貢獻代碼Cobble 不是普通的玩具項目而是一個「技術含量拉滿」的真實產品跨平臺實戰(zhàn)Flutter UI Kotlin Multiplatform 共享邏輯 原生 Swift/Kotlin 藍牙協(xié)議棧一套代碼同時服務 Pebble 手表生態(tài)。真實硬件對接涉及 BLE 藍牙、經(jīng)典藍牙串口、Speex 語音編解碼等底層技術學習價值極高。社區(qū)友好項目文檔、代碼風格規(guī)范、Golden 測試一應俱全非常適合作為第一個開源貢獻目標。如果你熟悉 Flutter 或 Kotlin 任一方向都能在這里找到合適的切入點。搭建 Cobble 開發(fā)環(huán)境需要哪些準備動手前先核對這份「裝備清單」依賴說明Git拉取倉庫與子模塊Flutter SDK項目通過 FVM 鎖定版本見.fvmrcAndroid StudioAndroid 端構建與模擬器Xcode可選僅 iOS 開發(fā)需要GitHub Token需read:packages權限用于拉取 libpebblecommonsCocoaPods僅 iOS 構建需要注意Cobble 對 Flutter 版本有嚴格要求因此官方推薦使用 FVMFlutter Version Management來安裝指定版本避免「本地能跑、提交就掛」的版本不一致問題。最簡配置步驟從克隆到首次運行第一步克隆倉庫并初始化子模塊git clone https://gitcode.com/gh_mirrors/mobi/mobile-app cd mobile-app git submodule update --init --recursive子模塊包含 Speex 語音編解碼庫speex、speexdsp、kissfft漏掉這一步會導致原生編譯失敗。第二步配置 GitHub Token 與 local.propertiesCobble 依賴 GitHub Packages 上的 libpebblecommons 私有包因此需要生成一個帶read:packages權限的 Token然后在android目錄下創(chuàng)建local.properties文件并寫入GITHUB_ACTOR你的GitHub用戶名 GITHUB_TOKEN生成的Token第三步用 FVM 安裝鎖定版本 Flutter# Ubuntu 系列可參考 sudo snap install flutter --classic dart pub global activate fvm # 在項目根目錄執(zhí)行自動安裝 .fvmrc 指定的版本 fvm install第四步拉取依賴并運行fvm flutter pub get fvm flutter emulators --launch Pixel_2_API_30 fvm flutter runiOS 專屬安裝 CocoaPodsbrew install ruby sudo gem install cocoapods之后執(zhí)行fvm flutter build ios會自動觸發(fā)pod install再用 Xcode 打開ios/Runner.xcodeproj即可構建。Cobble 項目結構完整解析搭建好環(huán)境后理解目錄結構是快速上手的關鍵。Cobble 采用「Flutter 殼 原生內核 KMP 共享層」的三層架構lib/Flutter 界面層所有 Dart 代碼都在 lib 目錄下入口文件為 main.dartlib/domain業(yè)務領域模型包括 API 客戶端、數(shù)據(jù)庫 DAO、通知、時間線等。lib/ui界面組件與頁面內置一套自研組件庫CobbleCard、CobbleTile 等統(tǒng)一通過主題管理樣式。lib/localization由lang目錄下的 JSON 自動生成的多語言模型。lib/infrastructure基礎設施包括 SQLite 數(shù)據(jù)源、Pigeon 橋接代碼等。android/sharedKotlin Multiplatform 共享層這是 Cobble 架構的核心亮點。android/shared 是一個 KMP 模塊用 Kotlin 編寫、通過commonMain共享業(yè)務邏輯數(shù)據(jù)庫、通知、時間線、JS 運行時等再分別編譯到 Android 與 iOS。開發(fā)新功能時優(yōu)先考慮把邏輯放進共享層兩端都能復用。android/原生 Android 模塊android/appAndroid 應用殼包含藍牙掃描、設備連接、Flutter Bridge 等原生代碼。android/pebble_bt_transport獨立封裝的 Pebble 藍牙傳輸層含 BLE 與經(jīng)典藍牙實現(xiàn)。android/pebblekit_android兼容 PebbleKit 舊 API 的適配庫。android/speex_codec語音編解碼的 C 原生實現(xiàn)。ios/原生 iOS 模塊ios/Runner 下同樣有完整的藍牙層bluetooth、Bridge 層bridges與 Pebble 協(xié)議處理PebbleProtocol與 Android 端一一對應。lang/ 與 pigeons/兩個容易被忽略的關鍵目錄lang每種語言一個 JSON 文件如 en.json新增文案后運行 build_runner 即可生成多語言模型。pigeonsPigeon 接口定義文件 pigeons.dart負責 Flutter 與原生之間的類型安全通信改完需要重新生成各端橋接代碼。新手必會的三個開發(fā)命令1. 生成映射代碼項目大量使用代碼生成JSON 序列化、數(shù)據(jù)庫映射、多語言模型修改相關文件后必須執(zhí)行fvm flutter pub run build_runner build --delete-conflicting-outputs2. 重新生成 Pigeon 橋接修改了 pigeons/pigeons.dart 后需要按 README 中的命令同步生成 Dart、Java、Objective-C 三端代碼確保通信接口一致。3. 運行測試fvm flutter testCobble 為 UI 組件準備了完整的 Golden 快照測試圖片存放在 test/components/goldens修改組件樣式后記得核對快照是否變化。給貢獻者的四點上手建議從 UI 組件入手先熟悉 lib/ui/common/components 下的 Cobble 系列組件改樣式、加頁面是風險最低的練手方式。先讀 README 再寫代碼項目根目錄 README.md 詳細說明了主題規(guī)范、導航規(guī)范與本地化規(guī)范遵循社區(qū)約定能大幅減少 Review 往返。邏輯盡量下沉到共享層能用 android/shared 的 Kotlin 代碼解決的問題就不要在兩端各寫一遍。提交前必跑測試Golden 測試與單元測試是 CI 的第一道門檻本地先過一遍再發(fā)起 Pull Request?？偨YCobble 是一個架構清晰、文檔完善、雙平臺實戰(zhàn)的開源項目從開發(fā)環(huán)境搭建到代碼提交的路徑并不復雜克隆倉庫 → 初始化子模塊 → 配置 Token 與 FVM → 跑通一次運行 → 從 UI 組件開始你的第一個改動。希望這份 Cobble 開發(fā)環(huán)境搭建與項目結構解析能幫你跨過門檻早日成為 Rebble 社區(qū)的一員【免費下載鏈接】mobile-appCobble: Rebble device companion app for iOS and Android項目地址: https://gitcode.com/gh_mirrors/mobi/mobile-app創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 從零開始為Cobble貢獻代碼：開發(fā)環(huán)境搭建與項目結構完整解析
從零開始為Cobble貢獻代碼開發(fā)環(huán)境搭建與項目結構完整解析【免費下載鏈接】mobile-appCobble: Rebble device companion app for iOS and Android項目地址: https://gitcode.com/gh_mirrors/mobi/mobile-appCobble 是 Rebble 社區(qū)為 Pebble/RebbleOS 智能手表打造的開源伴侶應用覆蓋 iOS 與 Android 雙平臺代碼完全開放。本文為想給 Cobble 貢獻代碼的新手準備了一份開發(fā)環(huán)境搭建保姆級教程并帶你完整梳理項目結構理解 Flutter 與 Kotlin Multiplatform 混合架構的協(xié)作方式幫你用最短時間從「看得懂」到「改得動」邁出提交第一個 Pull Request 的第一步。為什么值得為 Cobble 貢獻代碼Cobble 不是普通的玩具項目而是一個「技術含量拉滿」的真實產品跨平臺實戰(zhàn)Flutter UI Kotlin Multiplatform 共享邏輯 原生 Swift/Kotlin 藍牙協(xié)議棧一套代碼同時服務 Pebble 手表生態(tài)。真實硬件對接涉及 BLE 藍牙、經(jīng)典藍牙串口、Speex 語音編解碼等底層技術學習價值極高。社區(qū)友好項目文檔、代碼風格規(guī)范、Golden 測試一應俱全非常適合作為第一個開源貢獻目標。如果你熟悉 Flutter 或 Kotlin 任一方向都能在這里找到合適的切入點。搭建 Cobble 開發(fā)環(huán)境需要哪些準備動手前先核對這份「裝備清單」依賴說明Git拉取倉庫與子模塊Flutter SDK項目通過 FVM 鎖定版本見.fvmrcAndroid StudioAndroid 端構建與模擬器Xcode可選僅 iOS 開發(fā)需要GitHub Token需read:packages權限用于拉取 libpebblecommonsCocoaPods僅 iOS 構建需要注意Cobble 對 Flutter 版本有嚴格要求因此官方推薦使用 FVMFlutter Version Management來安裝指定版本避免「本地能跑、提交就掛」的版本不一致問題。最簡配置步驟從克隆到首次運行第一步克隆倉庫并初始化子模塊git clone https://gitcode.com/gh_mirrors/mobi/mobile-app cd mobile-app git submodule update --init --recursive子模塊包含 Speex 語音編解碼庫speex、speexdsp、kissfft漏掉這一步會導致原生編譯失敗。第二步配置 GitHub Token 與 local.propertiesCobble 依賴 GitHub Packages 上的 libpebblecommons 私有包因此需要生成一個帶read:packages權限的 Token然后在android目錄下創(chuàng)建local.properties文件并寫入GITHUB_ACTOR你的GitHub用戶名 GITHUB_TOKEN生成的Token第三步用 FVM 安裝鎖定版本 Flutter# Ubuntu 系列可參考 sudo snap install flutter --classic dart pub global activate fvm # 在項目根目錄執(zhí)行自動安裝 .fvmrc 指定的版本 fvm install第四步拉取依賴并運行fvm flutter pub get fvm flutter emulators --launch Pixel_2_API_30 fvm flutter runiOS 專屬安裝 CocoaPodsbrew install ruby sudo gem install cocoapods之后執(zhí)行fvm flutter build ios會自動觸發(fā)pod install再用 Xcode 打開ios/Runner.xcodeproj即可構建。Cobble 項目結構完整解析搭建好環(huán)境后理解目錄結構是快速上手的關鍵。Cobble 采用「Flutter 殼 原生內核 KMP 共享層」的三層架構lib/Flutter 界面層所有 Dart 代碼都在 lib 目錄下入口文件為 main.dartlib/domain業(yè)務領域模型包括 API 客戶端、數(shù)據(jù)庫 DAO、通知、時間線等。lib/ui界面組件與頁面內置一套自研組件庫CobbleCard、CobbleTile 等統(tǒng)一通過主題管理樣式。lib/localization由lang目錄下的 JSON 自動生成的多語言模型。lib/infrastructure基礎設施包括 SQLite 數(shù)據(jù)源、Pigeon 橋接代碼等。android/sharedKotlin Multiplatform 共享層這是 Cobble 架構的核心亮點。android/shared 是一個 KMP 模塊用 Kotlin 編寫、通過commonMain共享業(yè)務邏輯數(shù)據(jù)庫、通知、時間線、JS 運行時等再分別編譯到 Android 與 iOS。開發(fā)新功能時優(yōu)先考慮把邏輯放進共享層兩端都能復用。android/原生 Android 模塊android/appAndroid 應用殼包含藍牙掃描、設備連接、Flutter Bridge 等原生代碼。android/pebble_bt_transport獨立封裝的 Pebble 藍牙傳輸層含 BLE 與經(jīng)典藍牙實現(xiàn)。android/pebblekit_android兼容 PebbleKit 舊 API 的適配庫。android/speex_codec語音編解碼的 C 原生實現(xiàn)。ios/原生 iOS 模塊ios/Runner 下同樣有完整的藍牙層bluetooth、Bridge 層bridges與 Pebble 協(xié)議處理PebbleProtocol與 Android 端一一對應。lang/ 與 pigeons/兩個容易被忽略的關鍵目錄lang每種語言一個 JSON 文件如 en.json新增文案后運行 build_runner 即可生成多語言模型。pigeonsPigeon 接口定義文件 pigeons.dart負責 Flutter 與原生之間的類型安全通信改完需要重新生成各端橋接代碼。新手必會的三個開發(fā)命令1. 生成映射代碼項目大量使用代碼生成JSON 序列化、數(shù)據(jù)庫映射、多語言模型修改相關文件后必須執(zhí)行fvm flutter pub run build_runner build --delete-conflicting-outputs2. 重新生成 Pigeon 橋接修改了 pigeons/pigeons.dart 后需要按 README 中的命令同步生成 Dart、Java、Objective-C 三端代碼確保通信接口一致。3. 運行測試fvm flutter testCobble 為 UI 組件準備了完整的 Golden 快照測試圖片存放在 test/components/goldens修改組件樣式后記得核對快照是否變化。給貢獻者的四點上手建議從 UI 組件入手先熟悉 lib/ui/common/components 下的 Cobble 系列組件改樣式、加頁面是風險最低的練手方式。先讀 README 再寫代碼項目根目錄 README.md 詳細說明了主題規(guī)范、導航規(guī)范與本地化規(guī)范遵循社區(qū)約定能大幅減少 Review 往返。邏輯盡量下沉到共享層能用 android/shared 的 Kotlin 代碼解決的問題就不要在兩端各寫一遍。提交前必跑測試Golden 測試與單元測試是 CI 的第一道門檻本地先過一遍再發(fā)起 Pull Request?？偨YCobble 是一個架構清晰、文檔完善、雙平臺實戰(zhàn)的開源項目從開發(fā)環(huán)境搭建到代碼提交的路徑并不復雜克隆倉庫 → 初始化子模塊 → 配置 Token 與 FVM → 跑通一次運行 → 從 UI 組件開始你的第一個改動。希望這份 Cobble 開發(fā)環(huán)境搭建與項目結構解析能幫你跨過門檻早日成為 Rebble 社區(qū)的一員【免費下載鏈接】mobile-appCobble: Rebble device companion app for iOS and Android項目地址: https://gitcode.com/gh_mirrors/mobi/mobile-app創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考