在安卓项目中接入第三方SDK示例

2016-12-04 本文已影响0人爱是不求自己的益处

安卓入门示例之在项目中接入第三方SDK
本示例将演示如下内容：

使用android studio创建新项目
接入国内某家云服务服务商ANDROID SDK

创建项目

在android studio中新建一个项目

Next, 然后选择Minimum SDK

然后一路Next, Finish

项目创建完成后，切换到project

接入SDK

首先下载SDK

解压下载的sdk
然后在android studio导入依赖的sdk module

然后用同样的方式导入IMLib
如果报错，可能会提示你需要安装android sdk 21，如下图所示

从下图可以看到，Error中提示要install的部分安装完成后，代码中红色的错误标记被移除了

在java目录下创建App.java文件

在App.java中引用sdk的RongIM库，此时编辑器中会出现红色标记，表示我们还未添加该sdk到项目依赖中

Paste_Image.png

示例代码如下

package com.testproject;

import android.app.Application;

/**
 * Created by yang on 2016/12/3.
 */

public class App extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        RongIM
    }
}

打开app的module设置，并且添加依赖

Paste_Image.png

添加IMKit和IMLib模块后，再次输入RongIM.i，此时 Android Studio IDE会进行自动补全

Paste_Image.png

按下回车键，IDE会自动在文件的开始处导入库 import io.rong.imkit.RongIM;

Paste_Image.png

完整代码如下

package com.testproject;

import android.app.Application;

import io.rong.imkit.RongIM;

/**
 * Created by yang on 2016/12/3.
 */

public class App extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        RongIM.init(this);
    }
}

打开app\build.gradle文件，也证实我们成功的添加了对IMKit和IMLib模块的依赖

Paste_Image.png

在app的AndroidManifest中添加我们刚才创建的application name

Paste_Image.png

动手写一个demo

首先下载一个sdk的demo

Paste_Image.png

然后我们来仿造demo的配置，来动手写一个demo
在 IMLib 的 AndroidManifest 里配置好 App Key

Paste_Image.png

我们从demo项目中将App Key拷贝过来

Paste_Image.png

粘贴到TestProject的IMLib模块的 AndroidManifest中

Paste_Image.png

将demo项目中的权限配置拷贝过来

Paste_Image.png

权限配置如下

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <!-- 获取机型信息权限 -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />

    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.INTERACT_ACROSS_USERS_FULL" />

    <!-- 查看 Wi-Fi 状态 -->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!-- 查看网络状态 -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.CAMERA" />
    <!-- 录音 -->
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <!-- 控制振动器 -->
    <uses-permission android:name="android.permission.VIBRATE" />
    <!-- 防止设备休眠 -->
    <uses-permission android:name="android.permission.WAKE_LOCK" />

    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
    <uses-permission android:name="android.permission.KILL_BACKGROUND_PROCESSES" />
    <!--获取联系人信息，demo中演示发送通讯录消息-->
    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

粘贴到我们的项目中

Paste_Image.png

因为sealtalk这个项目比较复杂，我们选另一个比较简单的demo，作为我们的仿造对象，从这里下载或者直接从GITHUB下载

Paste_Image.png

在 MainActivity 中调用RongIM.connect() 连接融云。注意此处的 Token 为一个测试 Token，你需要换成你自己的 Token，这个 Token 还需要与 RONG_CLOUD_APP_KEY 匹配。

我们从demo-app-android-quick-start项目里选一个token，作为用户token

Paste_Image.png

我们将如下代码粘贴到 MainActivity.java

Paste_Image.png

代码如下

        String token = "d6bCQsXiupB/4OyGkh+TOrI6ZiT8q7s0UEaMPWY0lMxmHdi1v/AAJxOma4aYXyaivfPIJjNHdE+FMH9kV/Jrxg==";//test


        RongIM.connect(token, new RongIMClient.ConnectCallback() {

            /**
             * Token 错误，在线上环境下主要是因为 Token 已经过期，您需要向 App Server 重新请求一个新的 Token
             */
            @Override
            public void onTokenIncorrect() {

                Log.d("LoginActivity", "--onTokenIncorrect");
            }

            /**
             * 连接融云成功
             * @param userid 当前 token
             */
            @Override
            public void onSuccess(String userid) {

                Log.d("LoginActivity", "--onSuccess" + userid);
            }

            /**
             * 连接融云失败
             * @param errorCode 错误码，可到官网 查看错误码对应的注释
             */
            @Override
            public void onError(RongIMClient.ErrorCode errorCode) {

                Log.d("LoginActivity", "--onError" + errorCode);
            }
        });

MainActivity.java 完整代码如下：

package com.testproject;

import android.content.Intent;
import android.os.Bundle;
import android.support.design.widget.FloatingActionButton;
import android.support.design.widget.Snackbar;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.Toolbar;
import android.util.Log;
import android.view.View;
import android.view.Menu;
import android.view.MenuItem;

import io.rong.imkit.RongIM;
import io.rong.imlib.RongIMClient;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
        fab.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Snackbar.make(view, "Replace with your own action", Snackbar.LENGTH_LONG)
                        .setAction("Action", null).show();
            }
        });

        String token = "d6bCQsXiupB/4OyGkh+TOrI6ZiT8q7s0UEaMPWY0lMxmHdi1v/AAJxOma4aYXyaivfPIJjNHdE+FMH9kV/Jrxg==";//test


        RongIM.connect(token, new RongIMClient.ConnectCallback() {

            /**
             * Token 错误，在线上环境下主要是因为 Token 已经过期，您需要向 App Server 重新请求一个新的 Token
             */
            @Override
            public void onTokenIncorrect() {

                Log.d("LoginActivity", "--onTokenIncorrect");
            }

            /**
             * 连接融云成功
             * @param userid 当前 token
             */
            @Override
            public void onSuccess(String userid) {

                Log.d("LoginActivity", "--onSuccess" + userid);
            }

            /**
             * 连接融云失败
             * @param errorCode 错误码，可到官网 查看错误码对应的注释
             */
            @Override
            public void onError(RongIMClient.ErrorCode errorCode) {

                Log.d("LoginActivity", "--onError" + errorCode);
            }
        });
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.menu_main, menu);
        return true;
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        // Handle action bar item clicks here. The action bar will
        // automatically handle clicks on the Home/Up button, so long
        // as you specify a parent activity in AndroidManifest.xml.
        int id = item.getItemId();

        //noinspection SimplifiableIfStatement
        if (id == R.id.action_settings) {
            return true;
        }

        return super.onOptionsItemSelected(item);
    }
}

同时我们将demo-app-android-quick-start项目里的 RONG_CLOUD_APP_KEY 替换我们之前写在 TestProject\IMLib\AndroidManifest.xml 里的KEY