Skip to content

feat(share): integrate native Rust rendering runtime - #679

Open
YinCheng0106 wants to merge 3 commits into
mainfrom
feat/native-share-rendering
Open

YinCheng0106 wants to merge 3 commits into
mainfrom
feat/native-share-rendering

Conversation

@YinCheng0106

@YinCheng0106 YinCheng0106 commented Nov 21, 2026 •

Copy link
Copy Markdown
Member

這個 PR 做了什麼

  • 加入 ReportPicture 服務。在建立 renderer 前檢查 ABI 1.2 與 v2/16:9 能力。將原始 UTF-8 交給 Rust 驗證和渲染,回傳 Dart 持有的 PNG 或結構化錯誤。
  • 初始化與渲染在背景 isolate 執行。同一個 renderer 依序處理請求,dispose() 等待已接受的請求完成後釋放 handle。
  • 新增可重現的原生建置與封裝。iOS 靜態 XCFramework 包含裝置 arm64 和 Simulator arm64/x86_64,Runner 保留九個匯出供 DynamicLibrary.process() 查找。Android APK 封裝 arm64-v8a 與 x86_64 的 libeq_report_pic.so,沿用 DPIP 的 ABI 篩選。
  • 渲染服務目前由開發測試入口呼叫。地震報告詳情與系統分享介面留到下一階段。

相關 issue

  • Rust 與 Dart 綁定的來源是已合併的 eq-report-pic #12,固定為 b135d02bd1ba5103cd3d116a951b1b63a710a312。
  • 沿用 #677 的載入設計,從 DPIP main 獨立建置。#674 是直式分享卡的相關工作。

怎麼驗

檢查 結果
原生重建 Rust 1.99.1、Xcode 27.2、Android NDK 28.2.13676358。Cargo 使用固定提交的離線 vendor 封存檔。兩次重建的四份函式庫 SHA-256 一致。腳本輸出來源、工具鏈與每件產物的 SHA-256。
iOS iOS 27.2 ARM64 模擬器經 tool/run.sh 通過端到端、缺庫回傳 unavailable 和一般 DPIP 啟動。未簽署的裝置 Release 及模擬器 Debug 封裝各保留九個匯出。RunnerTests 421 項通過。
Android Android 17/API 37 ARM64 模擬器在 16 KiB 頁面且無對外路由時通過端到端。ABI 1.1 回傳 unsupportedAbi。原生探針確認 3 個 PNG 緩衝區與 2 個 renderer 都已釋放。Debug/Release APK 的兩種 ABI 均通過九個符號、ELF 對齊及 zipalign -P 16 檢查。一般 DPIP Release 已啟動。
PNG 兩平台均回報 ABI 1.2、能力 0x11F,成功解碼為 1920×1080。相同輸入的 PNG 共 195,390 bytes,SHA-256 為 d1a2080c35193928026c05e8aef2eb6fe4ce28c24a9a8bf0fd4b2b0f3c4cae5d。驗證連續請求、無效 JSON/版本、失敗後重試、釋放後解碼與重新開啟。
回歸 tool/check.sh 通過。Flutter 分析無問題,3,837 項測試通過、11 項跳過。 Android lint 通過。Android JVM 測試以 2 GiB 的本機測試 heap 重跑,620 項通過。

已知限制

  • 標準 CI 建置可省略選用的原生產物。啟用時從固定來源重建,保留字型與 Rust 相依授權。公開散布原生產物前仍須確認內嵌底圖及資產權利。
  • iOS/Android 實機、iOS Intel Simulator 及 Android x86_64 的執行驗收尚待進行。DPIP 的 Android 發布架構為 arm64-v8a 與 x86_64。

審查後補驗

  • 修正具名動態庫開啟後缺少原生符號時的分類。缺少 ABI 回 unsupportedAbi;載入失敗,以及 iOS process 沒有連結選用 renderer 時回 unavailable。原生回傳成功但未提供有效 PNG 緩衝區時會回結構化錯誤。

  • tool/dev/test_report_picture.sh 通過 18 項。涵蓋 ABI 與能力旗標、符號、Dart 持有 PNG 的副本、複製失敗時以原指標及長度釋放、佇列復原與 dispose。ABI 替身由 C 編譯,可在選用的 QA 工作執行。一般 Flutter CI 維持原有建置方式。

  • 同一固定離線 fixture 在 iOS 27.2 arm64 模擬器及 Android API 37、16 KiB arm64 模擬器均通過。ABI 1.2、能力 0x11f、九個符號。淺色與深色皆解碼為 1920×1080,同主題兩端 PNG 逐位元組一致。SHA-256 分別為 d1a2080c35193928026c05e8aef2eb6fe4ce28c24a9a8bf0fd4b2b0f3c4cae5d 與 9a87342fc68a1dfc854634a817d5096a2b7bed2c82f65a078f91316dcf3d2153。

  • 開發專用入口會記錄 fixture SHA、ABI、能力、尺寸、兩種主題的輸出路徑。操作步驟見 Native report-image renderer。維持既有 Rust 來源與 NDK 版本。兩平台使用的既有產物和字型均通過 SHA-256 清單驗證。

  • 本機 tool/check.sh 通過,Flutter 全套 3,840 項通過、18 項跳過,其中 7 項 ABI 替身須另跑。iOS RunnerTests 421 項、Android Instrumented 6 項通過。iOS 以未連結 Rust 的建置重跑,確認 open=unavailable。

檢查清單

  • tool/check/commits.sh origin/main..HEAD 通過。
  • 格式、分析、codegen 與 Flutter 全套回歸通過。
  • iOS/Android ARM64 模擬環境的離線 fixture 通過。
  • 建置與測試用產物保存在本機,提交包含來源、測試與授權資訊。

New(zh-Hant): 加入地震報告橫式分享圖的原生渲染基礎
New(en-US): Add native rendering support for landscape earthquake report images

Platform: all
Copilot AI balanced review requested due to automatic review settings November 21, 2026 18:58

This comment was marked as low quality.

@github-actions

github-actions Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

🔍 OpenCodeReview found 6 issue(s) in this PR.

  • ✅ Successfully posted inline: 5 comment(s)
  • 📝 In summary (no line info): 1 comment(s)

maintainability · low

📄 tool/dev/build_report_picture.sh

⚠️ GitHub could not post this as an inline comment: No line information provided

建置腳本中硬編碼了特定的 Android NDK 版本與 Git revision。雖然在開發工具中常見,但若未來環境升級或需要測試不同版本,建議考慮改為可配置的環境變數或參數。

💡 Suggested Change

Before:

ndk_version=28.2.13676358
revision=b135d02bd1ba5103cd3d116a951b1b63a710a312

After:

ndk_version="${EQ_REPORT_PIC_NDK_VERSION:-28.2.13676358}"
revision="${EQ_REPORT_PIC_REVISION:-b135d02bd1ba5103cd3d116a951b1b63a710a312}"

github-actions[bot]

This comment was marked as resolved.

@codecov

codecov Bot commented Nov 21, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 8.60215% with 170 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.27%. Comparing base (d88c21b) to head (b493a1f).

Files with missing lines Patch % Lines
...seismic/report_picture/eq_report_pic_bindings.dart 0.00% 86 Missing ⚠️
.../shared/seismic/report_picture/report_picture.dart 0.00% 73 Missing ⚠️
lib/core/platform/native_library.dart 61.53% 10 Missing ⚠️
lib/core/error/failure.dart 0.00% 1 Missing ⚠️

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Platform: all

Fix(zh-Hant): 區分分享圖卡原生函式庫缺失與不相容,並拒絕空白的原生輸出緩衝區
Fix(en-US): Distinguish missing and incompatible native share-card libraries and reject empty native output buffers

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants