release: v0.25.0

abc873693 · Sep 3, 2024 · 65195d2 · 65195d2
1 parent 5385e0d
commit 65195d2
Show file tree

Hide file tree

Showing 10 changed files with 41 additions and 44 deletions.
diff --git a/.github/workflows/firebase-hosting-merge.yml b/.github/workflows/firebase-hosting-merge.yml
@@ -9,9 +9,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2-beta
-        with:
-          node-version: '16.13'
       - name: Run Build
         working-directory: ./website
         run: |

diff --git a/.github/workflows/firebase-hosting-pull-request.yml b/.github/workflows/firebase-hosting-pull-request.yml
@@ -10,9 +10,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2-beta
-        with:
-          node-version: '16.13'
       - name: Run Build
         working-directory: ./website
         run: |

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,27 +1,15 @@
-## [0.25.0-dev.3] - 2024/09/02
+## [0.25.0] - 2024/09/03
 ### 基於 Flutter v3.24 開發
 
+* 升級 Flutter `3.24` API 變動所影響套件，並升級 Dart 版本至 `3.0`
 * 支援 Android predictive back
-
-## [0.25.0-dev.2] - 2024/09/01
-### 基於 Flutter v3.24 開發
-
 * 支援 NSYSU GDSC 相關訊息
 * `AboutUsPage` 支援 Instagram 欄位
 * 改善 `AboutUsPage` 連結行為
-
-## [0.25.0-dev.1] - 2024/08/29
-### 基於 Flutter v3.24 開發
-
 * 修正課表對話框 `CourseScaffoldSettingDialog` 高度錯誤
 * 修正 `OptionDialog` 高度錯誤
 * 範例補上 Android `desugaring` 所需設定 
 * 修正深色主題文字選取時的顏色
-
-## [0.25.0-dev.0] - 2024/08/22
-### 基於 Flutter v3.24 開發
-
-* 升級 Flutter `3.24` API 變動所影響套件，並升級 Dart 版本至 `3.0`
 * 修正課表下載權限檢查
 * 修改桌面版檔案儲存實作為 `file_saver`
 * 支援 Android target version `34` 相關

diff --git a/RELEASE_NOTE.md b/RELEASE_NOTE.md
@@ -1,3 +1,15 @@
 ### 基於 Flutter v3.24 開發
 
-* 支援 Android predictive back
+* 升級 Flutter `3.24` API 變動所影響套件，並升級 Dart 版本至 `3.0`
+* 支援 Android predictive back
+* 支援 NSYSU GDSC 相關訊息
+* `AboutUsPage` 支援 Instagram 欄位
+* 改善 `AboutUsPage` 連結行為
+* 修正課表對話框 `CourseScaffoldSettingDialog` 高度錯誤
+* 修正 `OptionDialog` 高度錯誤
+* 範例補上 Android `desugaring` 所需設定
+* 修正深色主題文字選取時的顏色
+* 修正課表下載權限檢查
+* 修改桌面版檔案儲存實作為 `file_saver`
+* 支援 Android target version `34` 相關
+    * `flutter_local_notification` 新版本 API
diff --git a/pubspec.yaml b/pubspec.yaml
@@ -1,6 +1,6 @@
 name: ap_common
 description: The school affairs(AP) series shares the engineering kit, rapid development of the school affairs series(AP) app
-version: 0.25.0-dev.3
+version: 0.25.0
 homepage: https://github.com/abc873693/ap_common
 
 environment:

diff --git a/website/docs/installation/app-tracking-transparency.mdx b/website/docs/installation/app-tracking-transparency.mdx
@@ -4,7 +4,7 @@ sidebar_position: 8
 
 # App 透明度追蹤
 
-因應 iOS 14 以後上架需加入 [`App 透明度追蹤 API`](https://developer.apple.com/documentation/apptrackingtransparency)
+因應 iOS 14 以後上架需加入 [`App 隱私權追蹤 API`](https://developer.apple.com/documentation/apptrackingtransparency)
 
 `iOS` 使用 [`app_tracking_transparency`](https://pub.dev/packages/app_tracking_transparency) 實作，細節可參考原專案
 

diff --git a/website/docs/installation/export-course-table-image.mdx b/website/docs/installation/export-course-table-image.mdx
@@ -13,39 +13,32 @@ sidebar_position: 6
 
 :::
 
-## 限制
-
-此功能只支援，默認相關功能會不顯示
-
-- Android
-- iOS
-- macOS
-- Winodws([有路徑問題](https://github.com/abc873693/ap_common/issues/66))
-- Linux([有路徑問題](https://github.com/abc873693/ap_common/issues/66))
-
-Web 版本可參考 [`issues`](https://github.com/abc873693/ap_common/issues/48)
-
 ## 設定
 
 ### Android
 
-因 Android 10 (Q API 29) 以後使用新的 API 存取檔案系統，至 `android/app/src/main/AndroidManifest.xml` 增加 `android:requestLegacyExternalStorage="true"`
+至 `android/app/src/main/AndroidManifest.xml` 增加相關權限設定
 
 ```xml title='AndroidManifest.xml'
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     package="com.examlpe.ap_common">
 
+    <!-- Permissions options for the `storage` group -->
+    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
+    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
+    <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
+    <uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED" />
+
     <application
         android:name="io.flutter.app.FlutterApplication"
         android:label="ap_common_example"
-        android:requestLegacyExternalStorage="true"
         android:icon="@mipmap/ic_launcher">
     </application>
 </manifest>
 ```
 
 :::caution 注意
-因為後續版本(Android 11) 會使 `requestLegacyExternalStorage` 無效，但仍建議加入使舊系統版本裝置支援
+因為目前 Play Store 自 2024/08/31 以後 不接受目標版本 `33` 以前的，故舊版必須遷移
 :::
 
 ### iOS

diff --git a/website/docs/installation/export-to-calendar.mdx b/website/docs/installation/export-to-calendar.mdx
@@ -24,15 +24,26 @@ sidebar_position: 5
 
 ### Android
 
-無須設定
+從 Android 11 (API 級別 30) 開始，Android 系統要求應用程式在 `AndroidManifest.xml` 設定。
+
+至 `android/app/src/main/AndroidManifest.xml` 增加相關權限設定
+
+```xml title='AndroidManifest.xml'
+<queries>
+  <intent>
+    <action android:name="android.intent.action.INSERT" />
+    <data android:mimeType="vnd.android.cursor.item/event" />
+  </intent>
+</queries>
+```
 
 ### iOS
 
 在 `ios/Runner/Info.plist` `dict` 中加入
 
 ```xml title='Info.plist'
   <key>NSCalendarsUsageDescription</key>
-	<string>Feature calendar would be add schedule to calendar app</string>
+  <string>Feature calendar would be add schedule to calendar app</string>
 ```
 
 字串中的說明為取得權限時會出現的文字說明，可根據你的 App 語言做修改

diff --git a/website/docs/installation/local-notification.mdx b/website/docs/installation/local-notification.mdx
@@ -25,9 +25,8 @@ sidebar_position: 4
 
 ### Android 
 
-自 [`flutter_local_notification v3.0.1+4`](https://pub.dev/packages/flutter_local_notifications/versions/3.0.1+4/changelog) 以後不需在專案中的 `android/app/scr/main/AndroidManifest.xml` 設定原生通知設定
 
-更多 `AndroidManifest.xml` 設定 [可參考](https://github.com/MaikuB/flutter_local_notifications/blob/master/flutter_local_notifications/example/android/app/src/main/AndroidManifest.xml)
+需至 `AndroidManifest.xml` 設定 [可參考](https://github.com/MaikuB/flutter_local_notifications/blob/master/flutter_local_notifications/example/android/app/src/main/AndroidManifest.xml#L49-L57)
 
 在 `app/scr/main/res/drawable` 加入 `ic_stat_name.png`，此圖是在通知顯示時在狀態列(status bar)顯示的圖案
 

diff --git a/website/docs/installation/overview.mdx b/website/docs/installation/overview.mdx
@@ -8,7 +8,7 @@ sidebar_position: 1
 
 ## 事前準備
 
- - [Flutter v2.0 以後](https://flutter.dev/docs/get-started/install) 並建立專案
+ - [Flutter v3.13 以後](https://flutter.dev/docs/get-started/install) 並建立專案
 
 ## 安裝流程 
 
@@ -19,7 +19,7 @@ sidebar_position: 1
 dependencies:
     flutter_localizations:
         sdk: flutter
-    ap_common: ^0.21.0
+    ap_common: ^0.25.0
 ```
 
 執行取得套件