npm 包 choo-persist-cordova 使用教程

阅读时长 6 分钟读完

介绍

npm 包 choo-persist-cordova 是一个适用于 Cordova 应用程序的数据持久化方案。它基于 choo-persist 并使用了 Cordova 的本地存储 API。choo-persist-cordova 已经被大量地应用在 Cordova 应用程序中,为开发者提供了一种非常方便的数据持久化方法。

在这篇文章中,我们将会介绍如何使用 choo-persist-cordova 来持久化 Cordova 应用程序中的数据。

安装

安装 choo-persist-cordova 很简单,只需要使用 npm 安装即可。

使用方法

在使用 choo-persist-cordova 之前,需要确保你已经按照 choo 的官方文档正确地安装和配置了 choo 框架。接下来,我们将介绍如何在一个简单的 choo 应用程序中使用 choo-persist-cordova。

存储数据

-- -------------------- ---- -------
----- ---- - ---------------
----- ------- - -------------------------------

----- --- - ------
----- ------- - ---------
  ----- --------
--

-------------------------

-----------
  ------ -
    ------ -
  --
  --------- -
    ---------- ------ ------ -- -
      ------ - ------ ----------- - ---- -
    -
  --
  -------- -
    ----- -------------- ------ ------ ----- ----- -
      ----- --- --------------- -- ------------------- ------
      ----------------- -- -----
    -
  -
---

------ -- -- -
  ----- ---- - -----------
  -------------------------------
  ----- --------------

  ----------- ------- ----- -- -
    -- ------ --- --------- -
      ------ -------------
    -
  --
----

上述代码演示了如何在一个简单的 choo 应用程序中使用 choo-persist-cordova。在这个应用程序中,我们定义了一个计数器状态,它的初始值为 0。我们还定义了一个 increment 的 reducer 和一个 incrementAsync 的 effect。 increment 给计数器加上一个参数,而 incrementAsync 则异步地执行 increment

使用 choo-persist-cordova 时,我们需要创建一个 Persist 类实例。在这个例子中,我们将 Persist 的实例赋值给一个变量叫做 persist。我们通过传递 name 选项配置了存储的名称。然后我们通过调用 plugin 方法使用 persist 插件。

注意到我们的 app 也使用了 persist.plugin() 去告诉 choo 框架使用该插件。

在应用程序的入口中,我们先调用 app.start() 将我们的应用程序运行出来,并创造了一个拥有根 state 的 tree。然后,我们将根元素添加到了 body 中。当然,在这些之前,我们调用了 persist.init() 初始化了 choo-persist-cordova。

最后,我们添加了一个事件监听器去检测应用程序的每个 render 事件,并调用 persist.set() 去将状态设置为当前值。

恢复数据

-- -------------------- ---- -------
----- ---- - ---------------
----- ------- - -------------------------------

----- --- - ------
----- ------- - ---------
  ----- --------
--

-------------------------

-----------
  ------ -
    ------ -
  --
  --------- -
    ---------- ------ ------ -- -
      ------ - ------ ----------- - ---- -
    -
  --
  -------- -
    ----- -------------- ------ ------ ----- ----- -
      ----- --- --------------- -- ------------------- ------
      ----------------- -- -----
    -
  -
---

------ -- -- -
  ----- ---- - -----------
  -------------------------------
  ----- --------------
  ----- -------------

  ----------- ------- ----- -- -
    -- ------ --- --------- -
      ------ -------------
    -
  --
----

上述代码展示了如何恢复 choo-persist-cordova 存储的数据。只需要在 persist.init() 后调用 persist.get() 即可。

深度学习

Persist 类提供了一些选项:

  • name:用于保存数据的本地存储库名。
  • version:覆盖版本字段,以强制组件进行重建并清除存储的数据。
  • whitelist:一些在存储中列入白名单的模型中的属性。只有这些属性会在持久化存储中保存下来。注意,这个选项是 choo-persist-cordova 特有的。
  • blacklist:与 whitelist 相反,但是 choo-persist-cordova 不支持这个选项。

总结

choo-persist-cordova 可以帮助开发者保存 Cordova 应用程序中的状态数据,以便在应用程序重新启动时恢复数据。使用 choo-persist-cordova 并没有太过依赖 Cordova 等其他组件,因此也可以在其他 JavaScript 应用程序中使用。通过可以按照本文的教程,个人开发者可以方便快捷地使用数据持久化功能。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60056c5b81e8991b448e5e3c

纠错
反馈