开放平台

    Android端

    定制版SDK提供客户可自定义logo和产品名称的功能,可以通过打包生成满足自己需求的App产品。

    1. 准备环境

    1.1 开发工具

    Android Studio 3.6 或以上版本。

    1.2 下载定制工具包

    请确保下载好定制工具包(点击下载),解压缩以后使用Android Studio打开项目即可。

    2. 工程结构介绍

    2.1 集成方主要关注app、buildSrc两个目录即可,如图所示:

    2.2 app目录结构和buildSrc目录结构

    • custom_keystore.jks为内置的打包签名,方便集成方直接打包apk。

    • CustomApplication.kt为全局功能配置文件,一般无需修改。

    • res-custom目录是集成方需要重点关注的目录,替换APP名称、Logo、启动图等都需要修改此目录下的文件,接下来的篇幅会做详细介绍。

    • KeyStoreParams.ktcustom_keystore.jks签名的详细参数,包含storePassword,keyAlias,keyPassword参数。

    可参考下图所示:

    3. 使用方法

    3.1 替换APP名称

    3.1.1 打开value/strings.xml文件,将文件顶部appName的节点内容更换成APP的英文名称。如示例APP的名称为‘Custom MeetNow’,集成方只需要将‘Custom MeetNow’替换为自己的APP的英文名称即可。

    3.1.2 打开value-zh-rCN/strings.xml文件,将文件顶部appName的节点内容更换成APP的中文名称。如示例APP的名称为‘定制化云会议’,集成方只需要将‘定制化云会议’替换为自己的APP的中文名称即可。

    3.2 替换APP LOGO

    mipmap-xxxhdpi/gnet_app_logo.png为APP的桌面 Logo

    (png格式,180 x 180 px)

    drawable-xhdpi/gnet_app_logo.png为APP启动图的 Logo

    (png格式,180 x 180 px)

    ul_ic_app_logo.png为APP登录页面的Logo

    (png格式,180 x180 px)

    以上3个Logo图片,本质上是一张图片,集成方需要将自己的Logo文件的命名和示例的Logo文件命名一致。

    3.3 替换启动图

    gnet_loading_bg.xml为启动图的布局文件,该布局文件使用layer-list实现,需要集成方对layer-list有一定的理解。

    如果已有的启动图模板不满足集成方的定制要求,集成方可以自由编辑此文件,实现自己想要的启动图效果。

    3.4 替换包名

    打开app模块的build.gradle文件,将applicationId改为集成方自己的包名。

    如示例APP的包名为‘com.gnet.custom.onemeeting’,集成方只需要将此包名替换为自己的包名即可。

    4. 打包生成APK

    4.1 在Android Studio的菜单栏,选择Build-Generate Signed Bundle / APK。

    4.2 勾选APK, 点击Next。

    4.3 选择签名文件,这里以实例签名文件举例,集成方也可使用自己的签名文件。

    4.4 输入storePassword,keyAlias,keyPassword参数, 点击Next即可

    示例签名custom_keystore.jks的参数值如下:

    • storePassword的值为111111

    • keyAlias的值为custom

    • keyPassword的值为111111

    这些值也可打开KeyStoreParams.kt文件查看。