From d723f6577b46d8bfb84dbaef72d60484544aa84c Mon Sep 17 00:00:00 2001
From: YuYu1015 <whes1015@gmail.com>
Date: Mon, 9 Nov 2026 18:48:00 +0800
Subject: [PATCH] feat(earthquake): let the report image be saved to the
 gallery
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Platform: all

New(zh-Hant): 地震報告圖可以儲存到相簿了
New(en-US): the report image can now be saved to your photo library
---
 android/app/src/main/AndroidManifest.xml      |   6 +
 ios/Runner/Info.plist                         |   2 +
 lib/core/platform/photo_library.dart          |  55 ++++++++
 .../pages/report_detail_page.dart             |  89 ++++++++++---
 lib/l10n/app_en.arb                           |  16 +++
 lib/l10n/app_fil.arb                          |   4 +
 lib/l10n/app_id.arb                           |   4 +
 lib/l10n/app_ja.arb                           |   4 +
 lib/l10n/app_ko.arb                           |   4 +
 lib/l10n/app_th.arb                           |   4 +
 lib/l10n/app_vi.arb                           |   4 +
 lib/l10n/app_yue.arb                          |   4 +
 lib/l10n/app_zh.arb                           |   4 +
 lib/l10n/app_zh_Hans.arb                      |   4 +
 lib/l10n/app_zh_Hant_HK.arb                   |   4 +
 lib/l10n/app_zh_TW.arb                        |   4 +
 lib/l10n/gen/app_localizations.dart           |  24 ++++
 lib/l10n/gen/app_localizations_en.dart        |  14 +++
 lib/l10n/gen/app_localizations_fil.dart       |  14 +++
 lib/l10n/gen/app_localizations_id.dart        |  14 +++
 lib/l10n/gen/app_localizations_ja.dart        |  13 ++
 lib/l10n/gen/app_localizations_ko.dart        |  13 ++
 lib/l10n/gen/app_localizations_th.dart        |  14 +++
 lib/l10n/gen/app_localizations_vi.dart        |  14 +++
 lib/l10n/gen/app_localizations_yue.dart       |  12 ++
 lib/l10n/gen/app_localizations_zh.dart        |  48 +++++++
 pubspec.lock                                  |   8 ++
 pubspec.yaml                                  |   7 ++
 test/core/platform/photo_library_test.dart    | 118 ++++++++++++++++++
 29 files changed, 507 insertions(+), 18 deletions(-)
 create mode 100644 lib/core/platform/photo_library.dart
 create mode 100644 test/core/platform/photo_library_test.dart

diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
index 7bf338d6c..a3813c250 100644
--- a/android/app/src/main/AndroidManifest.xml
+++ b/android/app/src/main/AndroidManifest.xml
@@ -20,6 +20,12 @@
     <!-- Onboarding "省電白名單": request Doze exemption so background reporting
          keeps running on aggressive battery managers (safety-app use). -->
     <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"/>
+    <!-- Saving the report image to the gallery (gal): Android 10+ writes
+         through MediaStore and needs no permission at all, so this is capped at
+         the API levels that still use the legacy external-storage write —
+         minSdk is 26, so those levels really are reachable. -->
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
+        android:maxSdkVersion="28"/>
 
     <!-- Bluetooth (meshtastic_flutter / flutter_blue_plus): connect to LoRa
          mesh radios over BLE. The maxSdkVersion=30 pair is the legacy API;
diff --git a/ios/Runner/Info.plist b/ios/Runner/Info.plist
index 122038ae4..e4cb140e8 100644
--- a/ios/Runner/Info.plist
+++ b/ios/Runner/Info.plist
@@ -59,6 +59,8 @@
 	<string>DPIP 需要在背景持續存取你的位置，即使關閉 App 也能為你所在地推送地震、天氣等災害警報。</string>
 	<key>NSLocationWhenInUseUsageDescription</key>
 	<string>DPIP 需要你的位置，以提供你所在地的地震、天氣等災害警報。</string>
+	<key>NSPhotoLibraryAddUsageDescription</key>
+	<string>DPIP 需要存取相簿，把你選擇的地震報告圖儲存到相簿。</string>
 	<key>NSUserActivityTypes</key>
 	<array>
 		<string>WeatherWidgetConfigurationIntent</string>
diff --git a/lib/core/platform/photo_library.dart b/lib/core/platform/photo_library.dart
new file mode 100644
index 000000000..359acfde1
--- /dev/null
+++ b/lib/core/platform/photo_library.dart
@@ -0,0 +1,55 @@
+import 'dart:typed_data';
+
+import 'package:dpip/core/logging/log.dart';
+import 'package:gal/gal.dart';
+
+/// How a save-to-photo-library attempt ended — the only three shapes the UI
+/// can say something different about.
+enum PhotoSaveOutcome {
+  /// The image is in the system photo library.
+  saved,
+
+  /// The user or the OS refused photo-library access.
+  permissionDenied,
+
+  /// Anything else: no space, bytes the platform cannot decode, a native
+  /// failure.
+  failed,
+}
+
+/// Writes image bytes into the system photo library (相簿).
+///
+/// `gal` is wrapped here rather than called from the report page so the page
+/// has no plugin dependency: this file owns the permission dance (ask once,
+/// report a refusal as [PhotoSaveOutcome.permissionDenied] instead of an
+/// exception) and the [GalException] → [PhotoSaveOutcome] mapping, and a test
+/// can stub the plugin's `gal` method channel.
+abstract final class PhotoLibrary {
+  const PhotoLibrary._();
+
+  /// Saves [bytes] as an image named [name].
+  ///
+  /// [name] carries no extension: the native side derives one from the bytes
+  /// themselves (Android guesses the format, iOS hands the name to Photos).
+  static Future<PhotoSaveOutcome> saveImage(
+    Uint8List bytes, {
+    required String name,
+  }) async {
+    try {
+      // `putImageBytes` asks for access on its own, but it throws away the
+      // answer and lets the native call fail with ACCESS_DENIED instead. Asking
+      // first turns a refusal into the outcome the UI can explain, and when the
+      // permission is already granted nothing is shown to the user.
+      if (!await Gal.hasAccess() && !await Gal.requestAccess()) {
+        return PhotoSaveOutcome.permissionDenied;
+      }
+      await Gal.putImageBytes(bytes, name: name);
+      return PhotoSaveOutcome.saved;
+    } on GalException catch (error) {
+      Log.error('photo library save failed', error, error.stackTrace);
+      return error.type == GalExceptionType.accessDenied
+          ? PhotoSaveOutcome.permissionDenied
+          : PhotoSaveOutcome.failed;
+    }
+  }
+}
diff --git a/lib/features/earthquake/presentation/pages/report_detail_page.dart b/lib/features/earthquake/presentation/pages/report_detail_page.dart
index 65157178d..5cf47129c 100644
--- a/lib/features/earthquake/presentation/pages/report_detail_page.dart
+++ b/lib/features/earthquake/presentation/pages/report_detail_page.dart
@@ -15,6 +15,7 @@ import 'package:dpip/core/geo/town_directory.dart';
 import 'package:dpip/core/logging/log.dart';
 import 'package:dpip/core/models/lat_lng.dart' as geo;
 import 'package:dpip/core/network/api_client.dart';
+import 'package:dpip/core/platform/photo_library.dart';
 import 'package:dpip/core/realtime/app_time.dart';
 import 'package:dpip/core/settings/home_area.dart';
 import 'package:dpip/core/settings/region_store.dart';
@@ -1685,6 +1686,36 @@ class _ReportImageCardState extends State<_ReportImageCard> {
   /// image itself sizes to its own natural proportions once loaded.
   static const double _placeholderHeight = 200;
 
+  /// A save is in flight — the button stays visible but disabled so a second
+  /// tap cannot start a second write to the gallery.
+  bool _saving = false;
+
+  /// The section is CWA's picture: save those exact bytes, never a screenshot
+  /// of the card, so what lands in the gallery is the official report at full
+  /// resolution rather than the on-screen, width-scaled copy.
+  Future<void> _save(BuildContext context, Uint8List bytes) async {
+    if (_saving) return;
+    final l10n = AppLocalizations.of(context);
+    final messenger = ScaffoldMessenger.maybeOf(context);
+    setState(() => _saving = true);
+    final outcome = await PhotoLibrary.saveImage(
+      bytes,
+      name: 'dpip-report-${widget.report.id}',
+    );
+    if (!mounted) return;
+    setState(() => _saving = false);
+    messenger?.showSnackBar(
+      SnackBar(
+        content: Text(switch (outcome) {
+          PhotoSaveOutcome.saved => l10n.reportDetailImageSaved,
+          PhotoSaveOutcome.permissionDenied =>
+            l10n.reportDetailImageSavePermission,
+          PhotoSaveOutcome.failed => l10n.reportDetailImageSaveFailed,
+        }),
+      ),
+    );
+  }
+
   @override
   Widget build(BuildContext context) {
     final l10n = AppLocalizations.of(context);
@@ -1720,26 +1751,48 @@ class _ReportImageCardState extends State<_ReportImageCard> {
             ),
           );
         }
-        return ClipRRect(
-          borderRadius: AppRadius.medium,
-          child: Image.memory(
-            snapshot.data!,
-            // No forced aspect ratio / BoxFit.cover — the report image's real
-            // proportions vary per event, so this sizes to the image's own
-            // natural aspect ratio at full width instead of cropping or padding.
-            width: double.infinity,
-            fit: BoxFit.contain,
-            errorBuilder: (context, error, stackTrace) => Container(
-              height: _placeholderHeight,
-              width: double.infinity,
-              color: colors.surfaceContainer,
-              alignment: Alignment.center,
-              child: Text(
-                l10n.reportDetailImageUnavailable,
-                style: TextStyle(color: colors.onSurfaceVariant),
+        return Column(
+          crossAxisAlignment: CrossAxisAlignment.stretch,
+          children: [
+            ClipRRect(
+              borderRadius: AppRadius.medium,
+              child: Image.memory(
+                snapshot.data!,
+                // No forced aspect ratio / BoxFit.cover — the report image's
+                // real proportions vary per event, so this sizes to the image's
+                // own natural aspect ratio at full width instead of cropping or
+                // padding.
+                width: double.infinity,
+                fit: BoxFit.contain,
+                errorBuilder: (context, error, stackTrace) => Container(
+                  height: _placeholderHeight,
+                  width: double.infinity,
+                  color: colors.surfaceContainer,
+                  alignment: Alignment.center,
+                  child: Text(
+                    l10n.reportDetailImageUnavailable,
+                    style: TextStyle(color: colors.onSurfaceVariant),
+                  ),
+                ),
               ),
             ),
-          ),
+            Align(
+              alignment: Alignment.centerRight,
+              child: TextButton.icon(
+                onPressed: _saving
+                    ? null
+                    : () => _save(context, snapshot.data!),
+                icon: _saving
+                    ? const SizedBox(
+                        width: 18,
+                        height: 18,
+                        child: CircularProgressIndicator(strokeWidth: 2),
+                      )
+                    : const Icon(Icons.download_outlined),
+                label: Text(l10n.reportDetailImageSave),
+              ),
+            ),
+          ],
         );
       },
     );
diff --git a/lib/l10n/app_en.arb b/lib/l10n/app_en.arb
index d25d04983..40a7f0f4d 100644
--- a/lib/l10n/app_en.arb
+++ b/lib/l10n/app_en.arb
@@ -365,6 +365,18 @@
   "@reportDetailImageUnavailable": {
     "description": "Shown in place of the report image when it fails to load"
   },
+  "@reportDetailImageSave": {
+    "description": "Button under the CWA report image that saves it to the photo library"
+  },
+  "@reportDetailImageSaved": {
+    "description": "Snackbar confirming the CWA report image was saved to the photo library"
+  },
+  "@reportDetailImageSavePermission": {
+    "description": "Snackbar shown when photo-library access is denied, so the report image cannot be saved"
+  },
+  "@reportDetailImageSaveFailed": {
+    "description": "Snackbar shown when saving the report image failed"
+  },
   "meshtasticFirmware": "Firmware",
   "@mapLayerMeshtastic": {
     "description": "Map layer name: mesh nodes"
@@ -1638,6 +1650,10 @@
     "description": "Rainfall accumulation since local midnight (API now)"
   },
   "reportDetailImageUnavailable": "Report image not available",
+  "reportDetailImageSave": "Save image",
+  "reportDetailImageSaved": "Saved to your photo library",
+  "reportDetailImageSavePermission": "Photo library access is off. Turn it on in system settings.",
+  "reportDetailImageSaveFailed": "Couldn't save the image. Try again.",
   "@weatherRankingMergeTo": {
     "description": "Label before township/county merge chips on ranking"
   },
diff --git a/lib/l10n/app_fil.arb b/lib/l10n/app_fil.arb
index 1992d4ab9..db2e538ac 100644
--- a/lib/l10n/app_fil.arb
+++ b/lib/l10n/app_fil.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "Pataas",
   "reportFilterApply": "I-apply",
   "reportDetailImageUnavailable": "Wala pang available na larawan ng ulat",
+  "reportDetailImageSave": "I-save ang larawan",
+  "reportDetailImageSaved": "Na-save sa photo library",
+  "reportDetailImageSavePermission": "Naka-off ang access sa photo library. I-on ito sa system settings.",
+  "reportDetailImageSaveFailed": "Hindi na-save ang larawan. Subukan muli.",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_id.arb b/lib/l10n/app_id.arb
index 363d4e242..edc7875a5 100644
--- a/lib/l10n/app_id.arb
+++ b/lib/l10n/app_id.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "Menaik",
   "reportFilterApply": "Terapkan",
   "reportDetailImageUnavailable": "Gambar laporan belum tersedia",
+  "reportDetailImageSave": "Simpan gambar",
+  "reportDetailImageSaved": "Tersimpan ke galeri foto",
+  "reportDetailImageSavePermission": "Akses galeri foto dimatikan. Aktifkan di pengaturan sistem.",
+  "reportDetailImageSaveFailed": "Gagal menyimpan gambar. Coba lagi.",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_ja.arb b/lib/l10n/app_ja.arb
index ccf68e033..adc21a003 100644
--- a/lib/l10n/app_ja.arb
+++ b/lib/l10n/app_ja.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "昇順",
   "reportFilterApply": "適用",
   "reportDetailImageUnavailable": "レポート画像はまだありません",
+  "reportDetailImageSave": "画像を保存",
+  "reportDetailImageSaved": "写真ライブラリに保存しました",
+  "reportDetailImageSavePermission": "写真ライブラリへのアクセスが許可されていません。システム設定から許可してください。",
+  "reportDetailImageSaveFailed": "画像を保存できませんでした。もう一度お試しください。",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_ko.arb b/lib/l10n/app_ko.arb
index 3dc77a78d..ec118adcc 100644
--- a/lib/l10n/app_ko.arb
+++ b/lib/l10n/app_ko.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "오름차순",
   "reportFilterApply": "적용",
   "reportDetailImageUnavailable": "보고서 이미지가 아직 없습니다",
+  "reportDetailImageSave": "이미지 저장",
+  "reportDetailImageSaved": "사진 보관함에 저장했습니다",
+  "reportDetailImageSavePermission": "사진 보관함 접근 권한이 없습니다. 시스템 설정에서 허용해 주세요.",
+  "reportDetailImageSaveFailed": "이미지를 저장하지 못했습니다. 다시 시도해 주세요.",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_th.arb b/lib/l10n/app_th.arb
index 3e9b8d828..72514d791 100644
--- a/lib/l10n/app_th.arb
+++ b/lib/l10n/app_th.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "น้อย→มาก",
   "reportFilterApply": "ใช้",
   "reportDetailImageUnavailable": "ยังไม่มีภาพรายงาน",
+  "reportDetailImageSave": "บันทึกรูปภาพ",
+  "reportDetailImageSaved": "บันทึกลงอัลบั้มภาพแล้ว",
+  "reportDetailImageSavePermission": "ไม่ได้รับสิทธิ์เข้าถึงอัลบั้มภาพ โปรดเปิดในตั้งค่าระบบ",
+  "reportDetailImageSaveFailed": "บันทึกรูปภาพไม่สำเร็จ โปรดลองอีกครั้ง",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_vi.arb b/lib/l10n/app_vi.arb
index ff4215d0f..cb7917fc8 100644
--- a/lib/l10n/app_vi.arb
+++ b/lib/l10n/app_vi.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "Tăng dần",
   "reportFilterApply": "Áp dụng",
   "reportDetailImageUnavailable": "Hình ảnh báo cáo chưa có sẵn",
+  "reportDetailImageSave": "Lưu ảnh",
+  "reportDetailImageSaved": "Đã lưu vào thư viện ảnh",
+  "reportDetailImageSavePermission": "Chưa được cấp quyền truy cập thư viện ảnh. Hãy bật trong cài đặt hệ thống.",
+  "reportDetailImageSaveFailed": "Không lưu được ảnh. Vui lòng thử lại.",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_yue.arb b/lib/l10n/app_yue.arb
index 6e56e73e8..2776d1f81 100644
--- a/lib/l10n/app_yue.arb
+++ b/lib/l10n/app_yue.arb
@@ -565,6 +565,10 @@
   "reportFilterOrderAsc": "升序",
   "reportFilterApply": "套用",
   "reportDetailImageUnavailable": "報告圖尚未提供",
+  "reportDetailImageSave": "儲存圖片",
+  "reportDetailImageSaved": "已儲存到相簿",
+  "reportDetailImageSavePermission": "冇相簿權限，請去系統設定開啟",
+  "reportDetailImageSaveFailed": "儲存失敗，請遲啲再試",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_zh.arb b/lib/l10n/app_zh.arb
index 4cdc24d8e..a1476b8bb 100644
--- a/lib/l10n/app_zh.arb
+++ b/lib/l10n/app_zh.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "升序",
   "reportFilterApply": "套用",
   "reportDetailImageUnavailable": "報告圖尚未提供",
+  "reportDetailImageSave": "儲存圖片",
+  "reportDetailImageSaved": "已儲存到相簿",
+  "reportDetailImageSavePermission": "沒有相簿權限，請到系統設定開啟",
+  "reportDetailImageSaveFailed": "儲存失敗，請稍後再試",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_zh_Hans.arb b/lib/l10n/app_zh_Hans.arb
index d374dbd61..6ad68d817 100644
--- a/lib/l10n/app_zh_Hans.arb
+++ b/lib/l10n/app_zh_Hans.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "升序",
   "reportFilterApply": "应用",
   "reportDetailImageUnavailable": "报告图尚未提供",
+  "reportDetailImageSave": "保存图片",
+  "reportDetailImageSaved": "已保存到相册",
+  "reportDetailImageSavePermission": "没有相册权限，请在系统设置中开启",
+  "reportDetailImageSaveFailed": "保存失败，请稍后再试",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_zh_Hant_HK.arb b/lib/l10n/app_zh_Hant_HK.arb
index 4d1e807e8..f2aa4dc6c 100644
--- a/lib/l10n/app_zh_Hant_HK.arb
+++ b/lib/l10n/app_zh_Hant_HK.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "升序",
   "reportFilterApply": "套用",
   "reportDetailImageUnavailable": "報告圖尚未提供",
+  "reportDetailImageSave": "儲存圖片",
+  "reportDetailImageSaved": "已儲存到相簿",
+  "reportDetailImageSavePermission": "沒有相簿權限，請到系統設定開啟",
+  "reportDetailImageSaveFailed": "儲存失敗，請稍後再試",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/app_zh_TW.arb b/lib/l10n/app_zh_TW.arb
index 3d2463435..d9283397b 100644
--- a/lib/l10n/app_zh_TW.arb
+++ b/lib/l10n/app_zh_TW.arb
@@ -563,6 +563,10 @@
   "reportFilterOrderAsc": "升序",
   "reportFilterApply": "套用",
   "reportDetailImageUnavailable": "報告圖尚未提供",
+  "reportDetailImageSave": "儲存圖片",
+  "reportDetailImageSaved": "已儲存到相簿",
+  "reportDetailImageSavePermission": "沒有相簿權限，請到系統設定開啟",
+  "reportDetailImageSaveFailed": "儲存失敗，請稍後再試",
   "@weatherModeSand": {
     "description": "Label for the weatherModeSand option in the experimental backdrop settings."
   },
diff --git a/lib/l10n/gen/app_localizations.dart b/lib/l10n/gen/app_localizations.dart
index cd838b19e..fde44d3ca 100644
--- a/lib/l10n/gen/app_localizations.dart
+++ b/lib/l10n/gen/app_localizations.dart
@@ -2382,6 +2382,30 @@ abstract class AppLocalizations {
   /// **'Report image not available'**
   String get reportDetailImageUnavailable;
 
+  /// Button under the CWA report image that saves it to the photo library
+  ///
+  /// In en, this message translates to:
+  /// **'Save image'**
+  String get reportDetailImageSave;
+
+  /// Snackbar confirming the CWA report image was saved to the photo library
+  ///
+  /// In en, this message translates to:
+  /// **'Saved to your photo library'**
+  String get reportDetailImageSaved;
+
+  /// Snackbar shown when photo-library access is denied, so the report image cannot be saved
+  ///
+  /// In en, this message translates to:
+  /// **'Photo library access is off. Turn it on in system settings.'**
+  String get reportDetailImageSavePermission;
+
+  /// Snackbar shown when saving the report image failed
+  ///
+  /// In en, this message translates to:
+  /// **'Couldn\'t save the image. Try again.'**
+  String get reportDetailImageSaveFailed;
+
   /// Button that opens the RTS/EEW replay starting from this report's origin time
   ///
   /// In en, this message translates to:
diff --git a/lib/l10n/gen/app_localizations_en.dart b/lib/l10n/gen/app_localizations_en.dart
index 0b0e36a9f..cfa1fea8c 100644
--- a/lib/l10n/gen/app_localizations_en.dart
+++ b/lib/l10n/gen/app_localizations_en.dart
@@ -1254,6 +1254,20 @@ class AppLocalizationsEn extends AppLocalizations {
   @override
   String get reportDetailImageUnavailable => 'Report image not available';
 
+  @override
+  String get reportDetailImageSave => 'Save image';
+
+  @override
+  String get reportDetailImageSaved => 'Saved to your photo library';
+
+  @override
+  String get reportDetailImageSavePermission =>
+      'Photo library access is off. Turn it on in system settings.';
+
+  @override
+  String get reportDetailImageSaveFailed =>
+      'Couldn\'t save the image. Try again.';
+
   @override
   String get reportDetailReplay => 'Replay';
 
diff --git a/lib/l10n/gen/app_localizations_fil.dart b/lib/l10n/gen/app_localizations_fil.dart
index 5a9248eb9..927deac44 100644
--- a/lib/l10n/gen/app_localizations_fil.dart
+++ b/lib/l10n/gen/app_localizations_fil.dart
@@ -1264,6 +1264,20 @@ class AppLocalizationsFil extends AppLocalizations {
   String get reportDetailImageUnavailable =>
       'Wala pang available na larawan ng ulat';
 
+  @override
+  String get reportDetailImageSave => 'I-save ang larawan';
+
+  @override
+  String get reportDetailImageSaved => 'Na-save sa photo library';
+
+  @override
+  String get reportDetailImageSavePermission =>
+      'Naka-off ang access sa photo library. I-on ito sa system settings.';
+
+  @override
+  String get reportDetailImageSaveFailed =>
+      'Hindi na-save ang larawan. Subukan muli.';
+
   @override
   String get reportDetailReplay => 'I-replay';
 
diff --git a/lib/l10n/gen/app_localizations_id.dart b/lib/l10n/gen/app_localizations_id.dart
index 500d4e64a..1ac85e457 100644
--- a/lib/l10n/gen/app_localizations_id.dart
+++ b/lib/l10n/gen/app_localizations_id.dart
@@ -1255,6 +1255,20 @@ class AppLocalizationsId extends AppLocalizations {
   @override
   String get reportDetailImageUnavailable => 'Gambar laporan belum tersedia';
 
+  @override
+  String get reportDetailImageSave => 'Simpan gambar';
+
+  @override
+  String get reportDetailImageSaved => 'Tersimpan ke galeri foto';
+
+  @override
+  String get reportDetailImageSavePermission =>
+      'Akses galeri foto dimatikan. Aktifkan di pengaturan sistem.';
+
+  @override
+  String get reportDetailImageSaveFailed =>
+      'Gagal menyimpan gambar. Coba lagi.';
+
   @override
   String get reportDetailReplay => 'Putar ulang';
 
diff --git a/lib/l10n/gen/app_localizations_ja.dart b/lib/l10n/gen/app_localizations_ja.dart
index 578f2ffe8..83175fe72 100644
--- a/lib/l10n/gen/app_localizations_ja.dart
+++ b/lib/l10n/gen/app_localizations_ja.dart
@@ -1231,6 +1231,19 @@ class AppLocalizationsJa extends AppLocalizations {
   @override
   String get reportDetailImageUnavailable => 'レポート画像はまだありません';
 
+  @override
+  String get reportDetailImageSave => '画像を保存';
+
+  @override
+  String get reportDetailImageSaved => '写真ライブラリに保存しました';
+
+  @override
+  String get reportDetailImageSavePermission =>
+      '写真ライブラリへのアクセスが許可されていません。システム設定から許可してください。';
+
+  @override
+  String get reportDetailImageSaveFailed => '画像を保存できませんでした。もう一度お試しください。';
+
   @override
   String get reportDetailReplay => 'リプレイ';
 
diff --git a/lib/l10n/gen/app_localizations_ko.dart b/lib/l10n/gen/app_localizations_ko.dart
index c52d95a72..bd54d63f1 100644
--- a/lib/l10n/gen/app_localizations_ko.dart
+++ b/lib/l10n/gen/app_localizations_ko.dart
@@ -1231,6 +1231,19 @@ class AppLocalizationsKo extends AppLocalizations {
   @override
   String get reportDetailImageUnavailable => '보고서 이미지가 아직 없습니다';
 
+  @override
+  String get reportDetailImageSave => '이미지 저장';
+
+  @override
+  String get reportDetailImageSaved => '사진 보관함에 저장했습니다';
+
+  @override
+  String get reportDetailImageSavePermission =>
+      '사진 보관함 접근 권한이 없습니다. 시스템 설정에서 허용해 주세요.';
+
+  @override
+  String get reportDetailImageSaveFailed => '이미지를 저장하지 못했습니다. 다시 시도해 주세요.';
+
   @override
   String get reportDetailReplay => '다시 보기';
 
diff --git a/lib/l10n/gen/app_localizations_th.dart b/lib/l10n/gen/app_localizations_th.dart
index dcb9d2621..8fc5b213c 100644
--- a/lib/l10n/gen/app_localizations_th.dart
+++ b/lib/l10n/gen/app_localizations_th.dart
@@ -1249,6 +1249,20 @@ class AppLocalizationsTh extends AppLocalizations {
   @override
   String get reportDetailImageUnavailable => 'ยังไม่มีภาพรายงาน';
 
+  @override
+  String get reportDetailImageSave => 'บันทึกรูปภาพ';
+
+  @override
+  String get reportDetailImageSaved => 'บันทึกลงอัลบั้มภาพแล้ว';
+
+  @override
+  String get reportDetailImageSavePermission =>
+      'ไม่ได้รับสิทธิ์เข้าถึงอัลบั้มภาพ โปรดเปิดในตั้งค่าระบบ';
+
+  @override
+  String get reportDetailImageSaveFailed =>
+      'บันทึกรูปภาพไม่สำเร็จ โปรดลองอีกครั้ง';
+
   @override
   String get reportDetailReplay => 'เล่นย้อนหลัง';
 
diff --git a/lib/l10n/gen/app_localizations_vi.dart b/lib/l10n/gen/app_localizations_vi.dart
index ef8494130..77f688d7e 100644
--- a/lib/l10n/gen/app_localizations_vi.dart
+++ b/lib/l10n/gen/app_localizations_vi.dart
@@ -1252,6 +1252,20 @@ class AppLocalizationsVi extends AppLocalizations {
   @override
   String get reportDetailImageUnavailable => 'Hình ảnh báo cáo chưa có sẵn';
 
+  @override
+  String get reportDetailImageSave => 'Lưu ảnh';
+
+  @override
+  String get reportDetailImageSaved => 'Đã lưu vào thư viện ảnh';
+
+  @override
+  String get reportDetailImageSavePermission =>
+      'Chưa được cấp quyền truy cập thư viện ảnh. Hãy bật trong cài đặt hệ thống.';
+
+  @override
+  String get reportDetailImageSaveFailed =>
+      'Không lưu được ảnh. Vui lòng thử lại.';
+
   @override
   String get reportDetailReplay => 'Phát lại';
 
diff --git a/lib/l10n/gen/app_localizations_yue.dart b/lib/l10n/gen/app_localizations_yue.dart
index 5b65778af..7683c1664 100644
--- a/lib/l10n/gen/app_localizations_yue.dart
+++ b/lib/l10n/gen/app_localizations_yue.dart
@@ -1222,6 +1222,18 @@ class AppLocalizationsYue extends AppLocalizations {
   @override
   String get reportDetailImageUnavailable => '報告圖尚未提供';
 
+  @override
+  String get reportDetailImageSave => '儲存圖片';
+
+  @override
+  String get reportDetailImageSaved => '已儲存到相簿';
+
+  @override
+  String get reportDetailImageSavePermission => '冇相簿權限，請去系統設定開啟';
+
+  @override
+  String get reportDetailImageSaveFailed => '儲存失敗，請遲啲再試';
+
   @override
   String get reportDetailReplay => '重播';
 
diff --git a/lib/l10n/gen/app_localizations_zh.dart b/lib/l10n/gen/app_localizations_zh.dart
index a8abe4261..0d9a18ba1 100644
--- a/lib/l10n/gen/app_localizations_zh.dart
+++ b/lib/l10n/gen/app_localizations_zh.dart
@@ -1222,6 +1222,18 @@ class AppLocalizationsZh extends AppLocalizations {
   @override
   String get reportDetailImageUnavailable => '報告圖尚未提供';
 
+  @override
+  String get reportDetailImageSave => '儲存圖片';
+
+  @override
+  String get reportDetailImageSaved => '已儲存到相簿';
+
+  @override
+  String get reportDetailImageSavePermission => '沒有相簿權限，請到系統設定開啟';
+
+  @override
+  String get reportDetailImageSaveFailed => '儲存失敗，請稍後再試';
+
   @override
   String get reportDetailReplay => '重播';
 
@@ -4765,6 +4777,18 @@ class AppLocalizationsZhHans extends AppLocalizationsZh {
   @override
   String get reportDetailImageUnavailable => '报告图尚未提供';
 
+  @override
+  String get reportDetailImageSave => '保存图片';
+
+  @override
+  String get reportDetailImageSaved => '已保存到相册';
+
+  @override
+  String get reportDetailImageSavePermission => '没有相册权限，请在系统设置中开启';
+
+  @override
+  String get reportDetailImageSaveFailed => '保存失败，请稍后再试';
+
   @override
   String get reportDetailReplay => '重播';
 
@@ -8307,6 +8331,18 @@ class AppLocalizationsZhHantHk extends AppLocalizationsZh {
   @override
   String get reportDetailImageUnavailable => '報告圖尚未提供';
 
+  @override
+  String get reportDetailImageSave => '儲存圖片';
+
+  @override
+  String get reportDetailImageSaved => '已儲存到相簿';
+
+  @override
+  String get reportDetailImageSavePermission => '沒有相簿權限，請到系統設定開啟';
+
+  @override
+  String get reportDetailImageSaveFailed => '儲存失敗，請稍後再試';
+
   @override
   String get reportDetailReplay => '重播';
 
@@ -11850,6 +11886,18 @@ class AppLocalizationsZhTw extends AppLocalizationsZh {
   @override
   String get reportDetailImageUnavailable => '報告圖尚未提供';
 
+  @override
+  String get reportDetailImageSave => '儲存圖片';
+
+  @override
+  String get reportDetailImageSaved => '已儲存到相簿';
+
+  @override
+  String get reportDetailImageSavePermission => '沒有相簿權限，請到系統設定開啟';
+
+  @override
+  String get reportDetailImageSaveFailed => '儲存失敗，請稍後再試';
+
   @override
   String get reportDetailReplay => '重播';
 
diff --git a/pubspec.lock b/pubspec.lock
index 38cc9f7aa..b797c2be8 100644
--- a/pubspec.lock
+++ b/pubspec.lock
@@ -469,6 +469,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "3.1.0"
+  gal:
+    dependency: "direct main"
+    description:
+      name: gal
+      sha256: f71e79840fe023a21f2f949771375444b6efcd34b9e625d5f4f5504971380a77
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.3.3"
   geoclue:
     dependency: transitive
     description:
diff --git a/pubspec.yaml b/pubspec.yaml
index eb6c8b663..a195d281d 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -114,6 +114,13 @@ dependencies:
   # Direct dep: MeshtasticClientImpl's device map holds flutter_blue_plus's
   # BluetoothDevice (meshtastic_flutter doesn't re-export it).
   flutter_blue_plus: ^1.36.8
+  # Saves the CWA report image to the system gallery (地震報告圖 → 儲存).
+  # Wrapped in lib/core/platform/photo_library.dart, which owns the permission
+  # prompt and turns every GalException into an outcome the UI can explain.
+  # iOS 15+/Android 26+ are both inside its floor; it ships a Swift Package
+  # Manager manifest (2.3.1+), which this project needs — there is no
+  # CocoaPods setup. Do not drop below 2.3.1.
+  gal: ^2.3.3
   # Direct dep: the impl requests Bluetooth/location permissions itself so a
   # denial surfaces a typed failure with a settings path.
   permission_handler: ^12.0.3
diff --git a/test/core/platform/photo_library_test.dart b/test/core/platform/photo_library_test.dart
new file mode 100644
index 000000000..a4d0356da
--- /dev/null
+++ b/test/core/platform/photo_library_test.dart
@@ -0,0 +1,118 @@
+import 'package:dpip/core/platform/photo_library.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  // The plugin's own channel — `gal` wraps every native call in it, so mocking
+  // it here exercises the real permission logic without a device.
+  const channel = MethodChannel('gal');
+  final messenger =
+      TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger;
+  final calls = <MethodCall>[];
+
+  /// Answers the plugin's three methods; [putError] is thrown from
+  /// `putImageBytes` when set, which is how a native failure reaches Dart.
+  void mockGal({
+    required bool hasAccess,
+    required bool grantsAccess,
+    PlatformException? putError,
+  }) {
+    messenger.setMockMethodCallHandler(channel, (call) async {
+      calls.add(call);
+      switch (call.method) {
+        case 'hasAccess':
+          return hasAccess;
+        case 'requestAccess':
+          return grantsAccess;
+        case 'putImageBytes':
+          if (putError != null) throw putError;
+          return null;
+      }
+      return null;
+    });
+  }
+
+  setUp(calls.clear);
+
+  tearDown(() => messenger.setMockMethodCallHandler(channel, null));
+
+  test('saves when access is already granted, without prompting', () async {
+    mockGal(hasAccess: true, grantsAccess: true);
+    final bytes = Uint8List.fromList([1, 2, 3]);
+
+    final outcome = await PhotoLibrary.saveImage(bytes, name: 'report');
+
+    expect(outcome, PhotoSaveOutcome.saved);
+    // `putImageBytes` re-checks access inside the plugin itself, so the channel
+    // sees a second `requestAccess` right before the write even here.
+    expect(calls.map((c) => c.method), [
+      'hasAccess',
+      'requestAccess',
+      'putImageBytes',
+    ]);
+    final put = calls.last.arguments as Map<Object?, Object?>;
+    expect(put['name'], 'report');
+    expect(put['bytes'], bytes);
+  });
+
+  test('prompts and saves when access is not granted yet', () async {
+    mockGal(hasAccess: false, grantsAccess: true);
+
+    final outcome = await PhotoLibrary.saveImage(
+      Uint8List.fromList([1]),
+      name: 'report',
+    );
+
+    expect(outcome, PhotoSaveOutcome.saved);
+    expect(calls.map((c) => c.method), [
+      'hasAccess',
+      'requestAccess',
+      'requestAccess',
+      'putImageBytes',
+    ]);
+  });
+
+  test('reports a refusal without attempting the write', () async {
+    mockGal(hasAccess: false, grantsAccess: false);
+
+    final outcome = await PhotoLibrary.saveImage(
+      Uint8List.fromList([1]),
+      name: 'report',
+    );
+
+    expect(outcome, PhotoSaveOutcome.permissionDenied);
+    expect(calls.map((c) => c.method), ['hasAccess', 'requestAccess']);
+  });
+
+  test('maps a native ACCESS_DENIED to permissionDenied', () async {
+    mockGal(
+      hasAccess: true,
+      grantsAccess: true,
+      putError: PlatformException(code: 'ACCESS_DENIED'),
+    );
+
+    final outcome = await PhotoLibrary.saveImage(
+      Uint8List.fromList([1]),
+      name: 'report',
+    );
+
+    expect(outcome, PhotoSaveOutcome.permissionDenied);
+  });
+
+  test('maps any other native failure to failed', () async {
+    mockGal(
+      hasAccess: true,
+      grantsAccess: true,
+      putError: PlatformException(code: 'NOT_ENOUGH_SPACE'),
+    );
+
+    final outcome = await PhotoLibrary.saveImage(
+      Uint8List.fromList([1]),
+      name: 'report',
+    );
+
+    expect(outcome, PhotoSaveOutcome.failed);
+  });
+}