logo资料库

完整版 mPass 架构介绍.pdf

第1页 / 共61页
第2页 / 共61页
第3页 / 共61页
第4页 / 共61页
第5页 / 共61页
第6页 / 共61页
第7页 / 共61页
第8页 / 共61页
资料共61页,剩余部分请下载后查看
1 接入指南
2 mPaaS 插件
3 快速开始
4 框架介绍
4.1 介绍
4.2 框架启动过程
5 在项目中使用 Material Design
6 混淆 Android 文件
7 常见问题
7.1 编译失败或卡顿
7.2 如何清除 Gradle 缓存
7.3 如何调试应用
8 基线列表
8.1 基线 10.0.18
8.2 基线 10.1.10
9 迁移至 Gradle 3.0
mPaaS Android 介绍文档 蚂蚁金融云
蚂蚁金融云版权所有 © 2017 ,并保留一切权利。 未经蚂蚁金融云事先书面许可,任何单位、公司或个人不得擅自摘抄、翻译、复制本文档内容的部分或全部,不得以任何方式或途径进行传播和宣传。 商标声明 及其他蚂蚁金融云服务相关的商标均为蚂蚁金融云所有。本文档涉及的第三方的注册商标,依法由权利人所有。 免责声明 由于产品版本升级、调整或其他原因,本文档内容有可能变更。蚂蚁金融云保留在没有任何通知或者提示下对本文档的内容进行修改的权利,并在蚂蚁金融云授权通道中不时发布更新后的用户文档。您应当实时关注用户文档的版本变更并通过蚂蚁金融云授权渠道下载、获取最新版的用户文档。如因文档使用不当造成的直接或间接损失,本公司不承担任何责任。Android 介绍蚂蚁金融云版权所有 © 2018
目录1 接入指南12 mPaaS 插件43 快速开始114 框架介绍25 4.1 介绍25 4.2 框架启动过程335 在项目中使用 Material Design376 混淆 Android 文件407 常见问题43 7.1 编译失败或卡顿43 7.2 如何清除 Gradle 缓存46 7.3 如何调试应用478 基线列表51 8.1 基线 10.0.1851 8.2 基线 10.1.10549 迁移至 Gradle 3.057Android 介绍蚂蚁金融云版权所有 © 2018
Android 介绍 1 接入指南 开发工具简介 Android Studio Plugin 是专门为使用 mPaaS 的开发者提供的一个 Android Studio 插件。使用该插件可以快速便捷地接 入 mPaaS Android 框架、生成加密图片(用于使用 mPaaS 的 Hotpatch、版本升级等功能时进行网络加密)、打包、检 测 bundle 升级等。 开发环境 在使用 mPaaS 的各种功能之前,需要设置一下本地开发环境: Java 环境 l 安装 JDK 8,并配置环境变量 JAVA_HOME,并将 JAVA_HOME 路径添加到 PATH 环境变量中。 Android Studio l 开发工具,若未安装可以下载 Android Studio 3.0.1。 l l Mac 版官方下载地址 Windows 版官方下载地址 注意:mPaaS Android 框架接入方式需要 3.0.x 3.1.x 版本的 Android Studio,因为 Android Studio 各版本代码 变化较大,Android Studio 插件只能针对某些版本适配,因此下载版本必须为 3.0.x 或者 3.1.x 版本的 Android Studio。 接入 mPaaS Android 框架需要修改 aapt 源码,目前 aapt 源码是基于 19.1 版本修改,由于高版本的 BuildTools 不兼容老版本,因此必须保证本地有 API Level 为 19 的 Android 版本。若没有安装,请在 SDK Manager 中下载。 下载步骤: - - - 启动 Android Studio 打开设置主界面(Mac 系统为 Preferences, Windows 系统为 Settings) 搜索框中输入 SDK,找到 Android SDK,勾选 API Level 为 19 的 Android 版本进行安装。 蚂蚁金融云版权所有 © 2018 1
Android 介绍 Gradle 环境 下载 Gradle(版本号 2.14.1)包,配置 GRADLE_HOME 环境变量,将 GRADLE_HOME/bin 添加到 PATH 中。 注意:由于 mPaaS Android 框架的 Gradle 插件是基于特定版本的 Android 插件开 发的,Gradle 版本之间互不兼容,所以需要安装 Gradle 2.14.1 版本。 配置完 GRADLE_HOME 之后需要配置 Android Studio 的 Preferences 的 Gradle Home, 其中路径使用本地的 Gradle 2.14.1 路径,如图: l 蚂蚁金融云版权所有 © 2018 2
Android 介绍 配置 BOOST_GRADLE_HOME 工具包环境,这是 mPaaS 插件运行时所依赖的一些小工具。 l 下载 BOOST_GRADLE_HOME 并解压到本地,配置 BOOST_GRADLE_HOME 环境变量为 解压路径,并且将 BOOST_GRADLE_HOME 路径添加到 PATH 环境变量。 安装插件 插件介绍 配置完环境之后即可安装 Android Studio 插件。每一个应用开发都应该安装该插件,插件不仅可以快速创建 mPaaS Android 框架的工程,给 mPaaS Android 框架打包,还可以完成 mPaaS 的必备功能,如:生成加密 图片(用于使用 mPaaS 的 Hotpatch、版本升级等功能时进行网络加密)、生成 Hotpatch 包等。 下载插件 使用金融云账户登录 下载页面 ( https://git.cloud.alipay.com/mpaas/mPaaS_Android_aar/blob/master/tools/boost_idea_mpaas3_0.zip ) ,点击 Download 下载 boost_idea_mpaas3_0.zip 插件。 安装插件 打开 Android Studio 的 Preferences > Plugins > Install plugin from disk 选择刚下载的插件 zip 包,如下 图: 蚂蚁金融云版权所有 © 2018 3
Android 介绍 下一步 - - 参考 mPaaS 插件 以详细了解插件的各个功能。 参考 快速开始 快速接入 mPaaS 功能。 2 mPaaS 插件 插件详解 mPaaS 包含了一个开发框架和众多的组件。如果开发新的 App,可以考虑直接使用 mPaaS框架,可以帮助实 现多团队协作开发,使 App 自动具备埋点,长连接等功能,可以更方便快速的集成组件。当然组件和框架之间 没有强依赖,如果只想在已有应用中添加某个组件功能,比如升级,那可以只集成这个组件。 根据不同的接入方式,mPaaS 插件提供相应的工具帮助开发者使用 mPaaS 开发的功能,包括新建 mPaaS 工 程,添加、删除和升级 mPaaS 组件,工程打包,重签名,埋点日志解析等。 - - Android Studio 插件有些功能是 mPaaS Android 框架才会使用(功能介绍中已标注:mPaaS Android 框架使用),关于 mPaaS Android 框架具体请参考 mPaaS Android 介绍文档 。 安装完插件之后会在 Android Studio 工具栏中出现 mPaaS 选项卡,点击该选项卡之后如下图所示 蚂蚁金融云版权所有 © 2018 4
Android 介绍 : Build - 打包编译(mPaaS Android 框架使用) 使用打包功能之前,先确保已经配置了 Build Setting。 编译 Bundle,以便在编译 Portal 时可以找到这个 Bundle。编译时,需要在 mPaaS 插件中点击 Build。 Build 按钮类似于执行了 Gradle 命令 gradle clean buildDebug(或者 buildRelease,取决于 settings 配置的是否为 debug 包) 编译完成之后打出的 Bundle 的包默认放在 m2 目录下。 - - Mac 默认路径 ~/.m2/repository Windows 默认路径 C:/Users/xxx/.m2/repository 注: 可改变默认路径,在 .m2 下面创建 settings.xml,把 localRepository 修改成希望存储的位置,内容 如下: /Users/yourName/.m2/repository Run - 运行 Portal 工程(mPaaS Android 框架使用) 蚂蚁金融云版权所有 © 2018 5
分享到:
收藏