# 准备开发环境

本章将介绍如何将 JC SDK 集成到您自己创建的项目中。

# 前提条件

Android SDK API 等级 16 或以上
Android Studio 3.5 及以上版本
支持 Android 4.1 或以上版本的移动设备
有效的菊风开发者账号（免费注册 (opens new window) ）
有效的菊风 AppKey

# 创建 Android 项目

参考以下步骤创建一个 Android 项目。若已有 Android 项目，可以直接查看【集成 SDK】。

打开 Android Studio，点击 Start a new Android Studio project。
在 Select a Project Template 界面，选择 Phone and Tablet -> Empty Activity，然后点击 Next。
在 Configure Your Project 界面，依次填入以下内容：
- Name：您的 Android 项目名称，如 HelloJuphoon。
- Package name：您的项目包的名称，如 io.helloJuphoon。
- Save location：项目的存储路径
- Language：项目的编程语言，如 Java
- Minimum API level：项目的最低 API 等级
然后点击 Finish。根据屏幕提示，安装可能需要的插件。

# 集成 SDK

您可以通过以下两种方式中任意一种集成 JC SDK：

# 方法一：使用 Maven 自动集成

在工程的 /build.gradle 文件中，添加如下内容：

 allprojects {
     repositories {
         ...
         maven { url 'https://repo1.maven.org/maven2/' }
         //或者 mavenCentral()
     }
 }

在 app 模块的 build.gradle 文件中添加依赖。通过 SDK 发版说明 (opens new window) 获取最新版本号，并将示例代码中 x.y.z 改为最新版本号：

// x.y.z 请填写具体版本号，如：2.13.2
// 可以通过 SDK 发版说明获取最新版本号
dependencies {
    implementation 'io.github.juphoon-app:jcsdk:x.y.z'
}

# 方法二：手动导入 JC SDK

下载 JC SDK (opens new window) 并解压。
拷贝 libs 文件夹内的 arm64-v8a、armeabi-v7a、x86、x86_64、JCSDK.jar、mtc.jar 和 zmf.jar 到您工程目录中的 libs 目录下。

为确保能够连接到 so 库，需要在 module 的 build.gradle 中添加设置:

sourceSets {
    main {
        jniLibs.srcDirs = ['libs']
    }
}

# 添加项目权限

根据场景需要，在 /app/src/main/AndroidManifest.xml 文件中添加如下行，获取相应的设备权限：

<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE"/> 
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

TIP

您在 AndroidManifest 中进行权限配置时，请确保您能够获得打开摄像头、音视频录制等相关权限。

# 设置APM

将 application 标签中的 extractNativeLibs 属性设置为 true。

前提条件

android： AGP >=3.6.0 且 minSdkVersion >= 23

  <application
        //...省略部分代码
        android:extractNativelibs="true"
       >
        //...省略部分代码
    </application>

# 设置混淆规则

在 proguard-rules.pro 文件，将 JC SDK 相关类加入不混淆名单。

-dontwarn com.juphoon.*
-keep class com.juphoon.**{*;}
//底层sdk
-dontwarn com.justalk.*
-keep class com.justalk.**{*;}
-keepattributes InnerClasses
-keep class **.R$* {*;}