Docs 菜单

Docs 主页 → 开发应用程序 → Atlas Device SDKs

安装 C++ SDK

在此页面上

  • 要求
  • 安装
  • 使用
  • 构建 Android 应用

适用于 C++ 的 Atlas Device SDK 使用 C++ 编写的客户端应用程序能够访问存储在设备上的数据并与 Atlas 同步数据。 本页详细介绍了如何在项目中安装 C++ SDK 并开始使用。

要求

  • 最低 C++ 标准：C++17。

  • 对于 macOS 上的开发：Xcode 11.x 或更高版本。

  • 对于 Windows 上的开发：Microsoft Visual C++ (MSVC)。

  • 否则，我们建议使用 git 和 CMake 。

安装

提示

Atlas Device SDK 和 Realm

SDK 使用 Realm Core 数据库实现设备数据持久化。 安装 C++ SDK 时，包名称会反映 Realm 命名方式。

使用

包含标头

通过在要使用 C++ SDK 的翻译单元中包含 cpprealm/sdk.hpp标头，使 C++ SDK 在代码中可用：

#include <cpprealm/sdk.hpp>

构建 Android 应用

C++ SDK 支持构建 Android 应用。 要构建 Android 应用，请执行以下操作：

  • 将<uses-permission android:name="android.permission.INTERNET" />添加到您的AndroidManifest.xml

  • 将 C++ SDK 的子目录添加到原生库的CMakeLists.txt并将其链接为目标库：

    set(CMAKE_CXX_STANDARD 17)
    add_subdirectory("realm-cpp")
    ...
    target_link_libraries(
       # Specifies the target library.
       myapplication
       # make sure to link the C++ SDK.
       cpprealm
    )

  • 在构建之前，确保 git 子模块已在realm-cpp文件夹内初始化。

  • 实例化数据库或 SDK 应用时，必须在相应构造函数或数据库打开模板中将filesDir.path作为path参数传递。

有关如何在 Android 应用中使用 C++ SDK 的示例，请参阅 Android RealmExample App 在realm-cpp GitHub 存储库中。

具体而言，请参阅 Android 示例应用中的MainActivity.kt和native-lib.cpp文件以获取代码示例。

← 适用于 C++ 的 Atlas Device SDK
快速入门 - C++ SDK →

在此页面上