DP-3T Android SDK 使用教程

项目介绍

DP-3T Android SDK 是一个用于 COVID-19 接触追踪的开源项目，基于蓝牙低功耗（Bluetooth Low Energy, BLE）技术。该项目确保个人数据和计算完全保留在用户的手机上，保护用户隐私。DP-3T 项目由来自 EPFL 和 ETHZ 的科学家和学术研究人员发起，并得到了欧洲广泛社区的审查和改进。

项目快速启动

环境准备

确保你的开发环境满足以下条件：

• Android Studio 最新版本
• Android SDK 21 或更高版本

集成 SDK

1. 克隆项目仓库

   git clone https://github.com/DP-3T/dp3t-sdk-android.git
   

2. 添加依赖 在你的 build.gradle 文件中添加以下依赖：

   dependencies {
       implementation 'org.dpppt:dp3t-sdk-android:2.2.0'
   }
   

3. 初始化 SDK 在你的 Application 类的 onCreate() 方法中初始化 SDK：

   import org.dpppt.android.sdk.DP3T;
   
   public class MyApplication extends Application {
       @Override
       public void onCreate() {
           super.onCreate();
           DP3T.init(this, "your-app-package-name");
       }
   }
   

使用 SDK

1. 检查状态

   DP3T.getStatus(context, new DP3T.StatusCallback() {
       @Override
       public void onSuccess(Status status) {
           // 处理状态
       }
   
       @Override
       public void onError(Throwable throwable) {
           // 处理错误
       }
   });
   

2. 清除数据

   DP3T.clearData(context, new Runnable() {
       @Override
       public void run() {
           // 数据清除后的操作
       }
   });
   

应用案例和最佳实践

应用案例

DP-3T Android SDK 已被用于多个国家的官方接触追踪应用，例如瑞士的 SwissCovid 应用。这些应用通过使用 DP-3T SDK，有效地追踪和通知用户可能的 COVID-19 接触，同时保护用户隐私。

最佳实践

• 隐私保护：确保用户数据仅用于接触追踪，并在合理时间内删除。
• 透明度：向用户清晰地解释数据收集和处理的过程。
• 安全性：定期更新 SDK 以修复任何安全漏洞。

典型生态项目

DP-3T 生态系统

DP-3T 项目不仅包括 Android SDK，还包括以下组件：

• iOS SDK：用于 iOS 设备的接触追踪 SDK。
• Backend SDK：用于后端服务的 SDK，处理接触追踪数据。
• 文档：详细的文档和白皮书，描述了 DP-3T 协议的实现细节。

这些组件共同构成了一个完整的接触追踪解决方案，支持全球范围内的 COVID-19 接触追踪工作。