
# Android SDK接入示例
本文介绍Android系统如何通过Amqp接入华为云物联网平台，接收服务端订阅消息的示例。
#### 准备工作
- 安装android studio。访问[android studio官网](https://developer.android.google.cn/studio/#downloads)，选择合适系统的版本下载并安装。（本文以windows 64-bit系统Android Studio 4.1.1为例）。
  图1下载android studio   
  ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002046416333.png "点击放大") 
- 安装JDK（也可以使用IDE自带的JDK）。
  1. 访问[Oracle官网](https://www.oracle.com/java/technologies/javase-downloads.html)，选择合适的JDK版本单击"Download"下载（本文以Windows x64 JDK8为例）。
  
  2. 下载完成后，运行安装文件，根据界面提示安装。
   
 
#### 开发环境
本示例所使用的开发环境如下：
- JDK1.8及以上。
- Android API 28 Platform及以上
- 本示例使用[Apache Qpid Proton-J](https://qpid.apache.org/proton/index.html)客户端。
 
#### 代码示例
1. 下载[Amqp Demo样例](https://iot-developer.obs.cn-north-4.myhuaweicloud.com/amqp/amqp-demo(android).zip)。
2. 运行Android Studio，单击"Open"，选择[1]中下载的样例。
   
   图2导入已有项目   
   ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002010511726.png "点击放大")
   
   
3. 完成代码导入。 
   图3导入项目结构   
   ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002599492705.png "点击放大")
   
   
4. (可选) 可以在res\\values\\strings.xml文件中提前配置Amqp连接参数，涉及的参数说明，请参考[AMQP客户端接入说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_2.html)。
   
   图4修改连接参数   
   ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002567783046.png "点击放大")
   
   
5. AVD Manager配置，选择任意设备模型并且API Level 28的虚拟设备用于调试。 
   图5配置AVD Manager   
   ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002010369234.png "点击放大")
   
   
6. 启动demo进行调试。 
   图6启动demo   
   ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002010373126.png "点击放大")
   
   
 
#### 使用展示
打开界面如下，其中"INSTANCE ID"在同一区域购买多个IoTDA标准版实例时必填，详细参数说明，请参考[AMQP客户端接入说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_2.html)。
图7Amqp连接配置   
![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002019751836.png "点击放大")
- 修改连接参数后连接成功界面如下：
  图8连接成功   
  ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002010550452.png "点击放大") 

- 获取流转数据成功界面如下：
  图9接收平台消息   
  ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002010542332.png "点击放大") 

- 网络连接失败界面如下：
  图10网络连接失败   
  ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002019904260.png "点击放大") 
- 接入信息（accessKey、accessCode、instanceId）错误界面如下：
  图11接入信息错误   
  ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002010390388.png "点击放大") 
- 队列不存在错误界面如下：
  图12队列不存在错误   
  ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002010390996.png "点击放大") 
 
