From eb84d2776ee70b6f5d29c77d2d58d014e701cc43 Mon Sep 17 00:00:00 2001
From: wang-yuanbai <603970629@qq.com>
Date: Wed, 3 Jan 2024 11:26:58 +0800
Subject: [PATCH 1/4] =?UTF-8?q?[Issues:=20#I8T6IX]=20=20=E6=96=B0=E5=A2=9E?=
 =?UTF-8?q?cameraroll=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 zh-cn/react-native-cameraroll.md | 270 +++++++++++++++++++++++++++++++
 1 file changed, 270 insertions(+)
 create mode 100644 zh-cn/react-native-cameraroll.md

diff --git a/zh-cn/react-native-cameraroll.md b/zh-cn/react-native-cameraroll.md
new file mode 100644
index 00000000..f78e76b0
--- /dev/null
+++ b/zh-cn/react-native-cameraroll.md
@@ -0,0 +1,270 @@
+> 模板版本：v0.1.1
+
+<p align="center">
+  <h1 align="center"> <code>react-native-cameraroll</code> </h1>
+</p>
+<p align="center">
+    <a href="https://github.com/react-native-cameraroll/react-native-cameraroll">
+        <img src="https://img.shields.io/badge/platforms-android%20|%20ios%20|%20harmony%20-lightgrey.svg" alt="Supported platforms" />
+    </a>
+        <a href="https://github.com/react-native-cameraroll/react-native-cameraroll/blob/master/LICENCE">
+        <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License" />
+    </a>
+</p>
+
+> [!tip] [Github 地址](https://github.com/react-native-oh-library/react-native-cameraroll)
+
+## 安装与使用
+
+进入到工程目录并输入以下命令：
+
+<!-- tabs:start -->
+
+#### **yarn**
+
+```bash
+yarn add @react-native-oh-tpl/camera-roll
+```
+
+#### **npm**
+
+```bash
+npm install @react-native-oh-tpl/camera-roll
+```
+
+<!-- tabs:end -->
+
+快速使用：
+
+```js
+import { View, Button } from "react-native";
+import {
+  CameraRoll,
+  harmonyRequestAddOnlyGalleryPermission,
+  harmonyRequestReadWriteGalleryPermission,
+} from "react-native-camera-roll/camera-roll";
+
+export default function App() {
+  return (
+    <View>
+      <Button
+        title="getPhotos"
+        onPress={() => {
+          CameraRoll.getPhotos({ first: 10 }).then((photos) => {
+            // TODO
+          });
+        }}
+      />
+      <Button
+        title="getAlbums"
+        onPress={() => {
+          CameraRoll.getAlbums({ assetType: "All" }).then((albums) => {
+            // TODO
+          });
+        }}
+      />
+      <Button
+        title="harmonyRequestAddOnlyGalleryPermission"
+        onPress={() => {
+          harmonyRequestAddOnlyGalleryPermission().then((status) => {
+            // TODO
+          });
+        }}
+      />
+      <Button
+        title="harmonyRequestReadWriteGalleryPermission"
+        onPress={() => {
+          harmonyRequestReadWriteGalleryPermission().then((status) => {
+            // TODO
+          });
+        }}
+      />
+    </View>
+  );
+}
+```
+
+## Link
+
+目前鸿蒙暂不支持 AutoLink，所以 Link 步骤需要手动配置。
+
+首先需要使用 DevEco Studio 打开项目里的鸿蒙工程 `harmony`
+
+### 引入原生端代码
+
+目前有两种方法：
+
+1. 通过 har 包引入（在 IDE 完善相关功能后该方法会被遗弃，目前首选此方法）；
+2. 直接链接源码。
+
+方法一：通过 har 包引入
+打开 `entry/oh-package.json5`，添加以下依赖
+
+```json
+"dependencies": {
+    "rnoh": "file:../rnoh",
+    "rnoh-camera-roll": "file:../../node_modules/@react-native-tpl-oh/camera-roll/harmony/camera_roll.har"
+  }
+```
+
+点击右上角的 `sync` 按钮
+
+或者在终端执行：
+
+```bash
+cd entry
+ohpm install
+```
+
+方法二：直接链接源码
+打开 `entry/oh-package.json5`，添加以下依赖
+
+```json
+"dependencies": {
+    "rnoh": "file:../rnoh",
+    "rnoh-camera-roll": "file:../../node_modules/@react-native-tpl-oh/camera-roll/harmony/camera_roll"
+  }
+```
+
+打开终端，执行：
+
+```bash
+cd entry
+ohpm install --no-link
+```
+
+### 配置 CMakeLists 和引入 CameraRollPackage
+
+打开 `entry/src/main/cpp/CMakeLists.txt`，添加：
+
+```diff
+project(rnapp)
+cmake_minimum_required(VERSION 3.4.1)
+set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
+set(OH_MODULE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")
+set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp")
+
+add_subdirectory("${RNOH_CPP_DIR}" ./rn)
+
+# RNOH_BEGIN: add_package_subdirectories
+add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
++ add_subdirectory("${OH_MODULE_DIR}/rnoh-camera-roll/src/main/cpp" ./camera-roll)
+# RNOH_END: add_package_subdirectories
+
+add_library(rnoh_app SHARED
+    "./PackageProvider.cpp"
+    "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp"
+)
+
+target_link_libraries(rnoh_app PUBLIC rnoh)
+
+# RNOH_BEGIN: link_packages
+target_link_libraries(rnoh_app PUBLIC rnoh_sample_package)
++ target_link_libraries(rnoh_app PUBLIC rnoh_camera_roll)
+# RNOH_END: link_packages
+```
+
+打开 `entry/src/main/cpp/PackageProvider.cpp`，添加：
+
+```diff
+#include "RNOH/PackageProvider.h"
+#include "SamplePackage.h"
++ #include "CameraRollPackage.h"
+
+using namespace rnoh;
+
+std::vector<std::shared_ptr<Package>> PackageProvider::getPackages(Package::Context ctx) {
+    return {
+      std::make_shared<SamplePackage>(ctx),
++     std::make_shared<CameraRollPackage>(ctx)
+    };
+}
+```
+
+### 在 ArkTs 侧引入 Gesture Handler Package
+
+打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加：
+
+```diff
+...
++ import { CameraRollPackage } from 'rnoh-camera-roll/ts';
+
+export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
+  return [
+    new SamplePackage(ctx),
++   new CameraRollPackage(ctx),
+  ];
+}
+```
+
+### 运行
+
+点击右上角的 `sync` 按钮
+
+或者在终端执行：
+
+```bash
+cd entry
+ohpm install
+```
+
+然后编译、运行即可。
+
+## 约束与限制
+
+### 兼容性
+
+要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。
+
+请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/camera-roll Releases](https://github.com/react-native-oh-library/react-native-cameraroll/releases)
+
+## 静态方法
+> [!tip] "Platform"列表示该属性在原三方库上支持的平台。
+
+> [!tip] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。
+
+**CameraRoll**
+| Name | Description | Type | Required | Platform | HarmonyOS Support  |
+| ---- | ----------- | ---- | -------- | -------- | ------------------ |
+| saveToCameraRoll | 保存图片/视频 | function | no | android,ios | no   |
+| getPhotos | 查找图片/视频 | function | no   | android,ios | partially |
+| getAlbums | 查找相册 | function | no   | android,ios      | partially |
+| deletePhotos | 删除图片/视频 | function | no  | android,ios  | no     |
+| iosGetImageDataById | 获取图片数据 | function | no  | ios    | no     |
+| getPhotoThumbnail | 获取缩略图 | function | no     | ios     | no     |
+
+
+
+## API
+> [!tip] "Platform"列表示该属性在原三方库上支持的平台。
+
+> [!tip] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。
+
+
+| Name | Description | Type | Required | Platform | HarmonyOS Support  |
+| ---- | ----------- | ---- | -------- | -------- | ------------------ |
+| `iosReadGalleryPermission` | 权限验证 | function | no    | ios  | no  |
+| `iosRequestReadWriteGalleryPermission` | 读写权限申请 | function | no  | ios  | no      |
+| `iosRequestAddOnlyGalleryPermission` | 添加权限申请 | function | no  | ios  | no      |
+| `iosRefreshGallerySelection` | 图片列表刷新 | function | no   | ios   | no  |
+| `harmonyReadGalleryPermission` | 对比`iosReadGalleryPermission` | function | no    | harmony  | no  |
+| `harmonyRequestReadWriteGalleryPermission` | 对比`iosRequestReadWriteGalleryPermission` | function | no  | harmony  | partially      |
+| `harmonyRequestAddOnlyGalleryPermission` | 对比`iosRequestAddOnlyGalleryPermission` | function | no  | harmony  | partially      |
+| `harmonyRefreshGallerySelection` | 对比`iosRefreshGallerySelection` | function | no   | harmony   | no  |
+
+
+## 遗留问题
+
+- [ ] harmony 保存图片/视频到指定相册需要使用系统接口
+- [ ] harmony 查找图片/视频部分查询条件和返回字段需要使用系统接口
+- [ ] harmony 纯图片相册暂未对外开放，系统相册不返回相册名
+- [ ] harmony 删除图片/视频需要使用系统接口
+- [ ] harmony 权限验证需要应用tokenID,获取tokenID需要使用系统接口
+- [ ] harmony 权限申请需要先验证权限，当前跳过验证，直接申请
+- [ ] harmony 暂无对标ios图片列表刷新的方法
+
+## 其他
+
+## 开源协议
+
+本项目基于 [The MIT License (MIT)](https://github.com/react-native-oh-library/react-native-linear-gradient/blob/harmony/LICENSE) ，请自由地享受和参与开源。
-- 
Gitee


From 9d83159377a130643c861caff9d4f82ff08dd583 Mon Sep 17 00:00:00 2001
From: wang-yuanbai <603970629@qq.com>
Date: Wed, 3 Jan 2024 11:28:47 +0800
Subject: [PATCH 2/4] =?UTF-8?q?[Issues:=20#I8T6IX]=20=20=E4=BF=AE=E6=94=B9?=
 =?UTF-8?q?=E6=A8=A1=E6=9D=BF=E7=89=88=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 zh-cn/react-native-cameraroll.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/zh-cn/react-native-cameraroll.md b/zh-cn/react-native-cameraroll.md
index f78e76b0..d247d654 100644
--- a/zh-cn/react-native-cameraroll.md
+++ b/zh-cn/react-native-cameraroll.md
@@ -1,4 +1,4 @@
-> 模板版本：v0.1.1
+> 模板版本：v0.1.2
 
 <p align="center">
   <h1 align="center"> <code>react-native-cameraroll</code> </h1>
-- 
Gitee


From 2616c5e3419e4df29d8255d77f2cca94930d8f91 Mon Sep 17 00:00:00 2001
From: wang-yuanbai <603970629@qq.com>
Date: Wed, 3 Jan 2024 15:51:18 +0800
Subject: [PATCH 3/4] =?UTF-8?q?[Issues:=20#I8T6IX]=20=20=E8=A1=A5=E5=85=85?=
 =?UTF-8?q?=E6=9D=83=E9=99=90=E7=94=B3=E8=AF=B7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 zh-cn/react-native-cameraroll.md | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/zh-cn/react-native-cameraroll.md b/zh-cn/react-native-cameraroll.md
index d247d654..865e2cb6 100644
--- a/zh-cn/react-native-cameraroll.md
+++ b/zh-cn/react-native-cameraroll.md
@@ -181,7 +181,7 @@ std::vector<std::shared_ptr<Package>> PackageProvider::getPackages(Package::Cont
 }
 ```
 
-### 在 ArkTs 侧引入 Gesture Handler Package
+### 在 ArkTs 侧引入 CameraRollPackage
 
 打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加：
 
@@ -196,6 +196,29 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
   ];
 }
 ```
+### 应用权限申请
+
+> [!tip] "ohos.permission.READ_IMAGEVIDEO"，"ohos.permission.WRITE_IMAGEVIDEO"权限等级为<B>system_basic</B>，授权方式为<B>user_grant</B>，[使用ACL签名的配置指导](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/signing-0000001587684945-V3#section157591551175916)
+
+在 `YourProject/entry/src/main/module.json5`补上配置
+
+```diff
+{
+  "module": {
+    "name": "entry",
+    "type": "entry",
+    
+  ···
+
+    "requestPermissions": [
++     { "name": "ohos.permission.READ_IMAGEVIDEO" },
++     { "name": "ohos.permission.WRITE_IMAGEVIDEO" }
+    ]
+  }
+}
+```
+
+
 
 ### 运行
 
-- 
Gitee


From f8410f5c7d7606a7bd5b36ea8d841a1e6d3fe657 Mon Sep 17 00:00:00 2001
From: wang-yuanbai <603970629@qq.com>
Date: Thu, 4 Jan 2024 10:09:24 +0800
Subject: [PATCH 4/4] =?UTF-8?q?[Issues:=20#I8T6IX]=20=20=E6=A0=B9=E6=8D=AE?=
 =?UTF-8?q?PR=E5=BB=BA=E8=AE=AE=E4=BF=AE=E6=94=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 zh-cn/react-native-cameraroll.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/zh-cn/react-native-cameraroll.md b/zh-cn/react-native-cameraroll.md
index 865e2cb6..f70f4629 100644
--- a/zh-cn/react-native-cameraroll.md
+++ b/zh-cn/react-native-cameraroll.md
@@ -20,16 +20,17 @@
 
 <!-- tabs:start -->
 
+**正在 npm 发布中，当前请先从仓库[Releases](https://github.com/react-native-oh-library/react-native-cameraroll/releases)中获取库 tgz，通过使用本地依赖来安装本库。**
 #### **yarn**
 
 ```bash
-yarn add @react-native-oh-tpl/camera-roll
+yarn add xxx
 ```
 
 #### **npm**
 
 ```bash
-npm install @react-native-oh-tpl/camera-roll
+npm install xxx
 ```
 
 <!-- tabs:end -->
-- 
Gitee