本文介绍如何快速使用日志服务 Android SDK 实现基础的日志采集流程。

前提条件 #

已安装日志服务 Android SDK。更多信息，请参见安装 SDK。

注意事项 #

日志服务的日志上传基于 http 协议，而 Android 11.0 使用 HttpUrlConnection 进行 http 请求会出现以下异常。

W/System.err: java.io.IOException: Cleartext HTTP traffic to **** not permitted

对于 Android 11.0 及后续版本版本，需要执行以下操作：

1. 在项目的 res 文件夹下创建一个名为 xml 的文件夹，然后创建 network_security_config.xml 文件。
   文件内容如下，其中 tls-cn-beijing.volces.com 应修改为实际使用的服务地址。

   <?xml version="1.0" encoding="utf-8"?>
   <network-security-config>
       <domain-config cleartextTrafficPermitted="true">
           <domain includeSubdomains="true">tls-cn-beijing.volces.com</domain>
       </domain-config>
   </network-security-config>
   

2. 修改 AndroidManifest.xml 文件，在 application 标签中增加以下属性：

   <application
       ...
       android:networkSecurityConfig="@xml/network_security_config"
       ...
   />
   

示例项目 #

日志服务在 GitHub 中提供了一个开源的日志采集示例项目 android-demo 供您参考。您可以通过此示例项目测试日志服务 Android SDK 的日志采集能力，跑通日志采集流程。

1. 通过示例项目创建 Android 应用程序。
   1. 在 GitHub 中下载示例项目的源码。
   2. 通过 Android Studio 创建项目，并导入源码文件。
   3. 在 PutLogExample.java 文件的属性部分中配置火山引擎密钥及 Topic ID 等信息。
2. 测试Android SDK的采集能力。
   1. 将 Android 设备连接至计算机。
   2. 在 Android Studio 里点击 Run 'app'。
      成功运行后，示例项目会安装到指定 Android 设备中。
   3. 启动 App，并根据提示发送日志。
      日志服务 Android SDK 会采集应用程序的日志数据，并自动发送至指定的日志主题中，您可以在日志服务控制台中预览这些日志数据。