React Native Encrypted Storage 常见问题解决方案

React Native Encrypted Storage 常见问题解决方案

react-native-encrypted-storage React Native wrapper around EncryptedSharedPreferences and Keychain to provide a secure alternative to Async Storage. 项目地址: https://gitcode.com/gh_mirrors/re/react-native-encrypted-storage

项目基础介绍

React Native Encrypted Storage 是一个用于 React Native 应用的加密存储库，旨在提供比 Async Storage 更安全的存储解决方案。它通过封装 Android 的 EncryptedSharedPreferences 和 iOS 的 Keychain，确保敏感数据（如访问令牌、支付信息等）的安全存储。该项目支持 TypeScript，并且适用于 Android API 21+ 和 iOS 2.0 以上的版本。

主要的编程语言包括 JavaScript 和 TypeScript。

新手使用注意事项及解决方案

1. 安装和链接问题

问题描述：新手在安装和链接 React Native Encrypted Storage 时可能会遇到依赖安装失败或链接不成功的问题。

解决步骤：

1. 安装依赖：

   • 使用 Yarn 安装：

     yarn add react-native-encrypted-storage
     

   • 使用 npm 安装：

     npm install react-native-encrypted-storage
     

2. 自动链接（适用于 React Native 0.60+）：

   • 无需额外步骤，React Native 0.60+ 支持自动链接。

3. 手动链接（适用于 React Native 0.59 及以下版本）：

   • 运行以下命令：

     react-native link react-native-encrypted-storage
     

4. iOS 特殊处理：

   • 如果使用 CocoaPods，运行：

     npx pod-install
     

2. 存储和检索数据问题

问题描述：新手在使用 setItem 和 getItem 方法时可能会遇到数据存储或检索失败的问题。

解决步骤：

1. 存储数据：

   • 确保数据格式正确，使用 JSON.stringify 将对象转换为字符串：

     import EncryptedStorage from 'react-native-encrypted-storage';
     
     async function storeUserSession() {
       try {
         await EncryptedStorage.setItem(
           "user_session",
           JSON.stringify({
             age: 21,
             token: "ACCESS_TOKEN",
             username: "emeraldsanto",
             languages: ["fr", "en", "de"]
           })
         );
         console.log("数据存储成功");
       } catch (error) {
         console.error("存储数据时出错:", error);
       }
     }
     

2. 检索数据：

   • 使用 getItem 方法检索数据，并使用 JSON.parse 将字符串转换回对象：

     async function retrieveUserSession() {
       try {
         const session = await EncryptedStorage.getItem("user_session");
         if (session !== undefined) {
           const parsedSession = JSON.parse(session);
           console.log("检索到的数据:", parsedSession);
         } else {
           console.log("未找到数据");
         }
       } catch (error) {
         console.error("检索数据时出错:", error);
       }
     }
     

3. 清除和移除数据问题

问题描述：新手在使用 removeItem 和 clear 方法时可能会遇到数据无法清除或移除的问题。

解决步骤：

1. 移除单个数据项：

   • 使用 removeItem 方法移除指定的数据项：

     async function removeUserSession() {
       try {
         await EncryptedStorage.removeItem("user_session");
         console.log("数据项已移除");
       } catch (error) {
         console.error("移除数据项时出错:", error);
       }
     }
     

2. 清除所有数据：

   • 使用 clear 方法清除所有存储的数据：

     async function clearAllData() {
       try {
         await EncryptedStorage.clear();
         console.log("所有数据已清除");
       } catch (error) {
         console.error("清除数据时出错:", error);
       }
     }
     

通过以上步骤，新手可以顺利解决在使用 React Native Encrypted Storage 项目时遇到的常见问题。

react-native-encrypted-storage React Native wrapper around EncryptedSharedPreferences and Keychain to provide a secure alternative to Async Storage. 项目地址: https://gitcode.com/gh_mirrors/re/react-native-encrypted-storage