本文介绍如何快速跑通示例源码,体验即时通讯服务。
在开始集成 ZIM SDK 前,请确保开发环境满足以下要求(以下说明皆以 macOS 开发电脑为例):
目前,ZEGO 控制台 仅支持 iOS/Android/macOS/Windows 平台的 ZIM 服务自助开通使用;暂不支持 Web/小程序 平台的服务自助开通。
开发者如需使用 Web/小程序 平台的 SDK,请联系 ZEGO 技术支持,配置相关服务权限。
下列结构为 IM 源码文件的子目录结构,下文所涉及的文件路径均为相对于此目录的路径。
.
├── app
│ ├── agconnect-services.json
│ ├── build
│ │ ├── generated
│ │ ├── intermediates
│ │ ├── outputs
│ │ └── tmp
│ ├── build.gradle
│ ├── libs
│ │ ├── MiPush_SDK_Client_4_9_1.jar
│ │ ├── VERSION.txt
│ │ ├── ZIM.jar
│ │ ├── arm64-v8a
│ │ ├── armeabi-v7a
│ │ ├── pushOpenClient_v3.0.0.4_484_81c1f83_release.jar
│ │ ├── x86
│ │ ├── x86_64
│ │ └── zpns-release.aar
│ ├── proguard-rules.pro
│ ├── src
│ │ └── main
│ └── zim_example_key.jks
├── build.gradle
├── gradle
│ └── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradle.properties
├── gradlew
├── gradlew.bat
├── local.properties
└── settings.gradle
在开发电脑中找到 Android Studio 软件图标。
打开 Android Studio,单击 “Open an Existing Project”。
在解压后的示例源码文件夹中,选择 “ZIMExampleJava” 文件夹,并单击 “Open” 打开。
请参考 下载 SDK,下载最新版本的 SDK 包,解压后将文件拷贝到示例源码的 “app/libs” 目录下。
下载的示例源码中缺少 SDK 初始化所需的 appID 和 secret,需要修改 “ZIMExample/app/src/main/java/im/zego/zimexample” 目录下的 “KeyCenter.java” 文件。请使用本文 3 前提条件 已获取的 AppID 和 Secret 正确填写(注意:需要在 AppID 后加 L),否则示例源码无法正常运行。
将 Android 设备链接到开发电脑,当该设备成功开启“开发者模式”和“USB 调试”功能后,可以看到 Android Studio 上方的 “Running Devices” 选项框由下图:
变为下图:
单击 “Run” 按钮,编译并运行示例源码。
Android Studio 运行下载的示例源码时报错:“错误:不兼容的类型:缺少返回值”,如何处理?
由于下载的示例源码中,appID 和 secret 没有具体的值,请参考本文 “5 运行示例源码” 章节中的步骤 5 进行处理。
联系我们
文档反馈