mPass 架构介绍

【实例简介】
mPass模块化，Android开发模块化使用，开源框架，注册使用
Android介绍 目录 1接入指南 2 m PaaS插件 3快速开始 4框架介绍 25 4.1介绍 ...25 42框架启动过程 5在项目中使用 Material Design 37 6混淆 Android文件 40 7常见问题 43 71编译失败或卡顿 43 7.2如何清除 Gradle缓存 73如何调试应用 47 8基线列表 51 81基线10018 82基线10110 54 9迁移至 Grade3.0 57 吗蚁金融云版权所有⊙201 Android介绍 1接入指南 开发工具简介 Android Studio Plugin是专门为使用 mPaas的开发者提供的一个 Android studio插件。使用该插件可以快速便捷地接 入 m PaaS android框架、生成加密图片(用于使用mPaS的 Hotpatch、版本升级等功能时进行网络加密)、打包、检 测 bundle升级等 开发环境 在使用 mPaas的各种功能之前,需要设置一下本地开发环境 Java环境 安装JDκ8,并配置环境变量JAVA_HOME,并将 JAVA HOME路径添加到PATH环境变量中。 Android studio 开发工具,若未安装可以下载 Android studio3.0.1。 Mac版官方下载地址 Windows版官方下载地址 注意: m Paas android框架接入方式需要3.0.×3.1.x版本的 Android studio,因为 Android studio各版本代码 变化较大, Android studio插件只能针对某些版本适配,因此下载版本必须为3.0×或者3.1.X版本的 Android Studio。 接入 m PaaS Android框架需要修改apt源码,目前aapt源码是基于19.1版本修改,由于高版本的 Buildtools 不兼容老版本,因此必须保证本地有 API Level.19的 Android版本。若没有安装,请在 SDK Manager中下载。 下载步骤 启动 Android studio 打开设置主界面(MaC系统为 Preferences, Windows系统为 Settings) 搜索框中输入SDK,找到 Android SDK,勾选 API Level为19的 Android版本进行安装 吗蚁金融云版权所有Q2018 1 Android介绍 Preferen Q Android c Appearance Behavior System Settings Androld SDK Appearance Behavior Manager for the Android SDK and Tools used by Android Studio v System Settings Android SDK Location: /Users/xunlong wxl/Library/Android/sdk Android SDK SDK Platforms SDK Tools SDK Update Sites Notifications Each Android SDK Platform package includes the Android platform and sources pertaining Keymap an API level by default. once stalled, Android Studio will automatically check for updater o Editor Check"show package details"to display individual SDK components. Y General Android 7.1. 1(Nougat) Partially installed Code Foleing V Android 7.0 (Nougat) 2 2 Partially Installed v Colors Fonts oid N Preview N 1 Partially installed 6.0(Marshmallow) 3 Insta lled Android Logcat 5.1(Lollipop) 2 Insta lled Inspections Insta lled File and Code Templates LIve Templates V Android 4. 4(Kitkat Insta lled Layout Edit Android 2. 1(Eclair) Insta lled Plugins Build, Execution, Deployment Y Data Views Compiler Show Pack aunch Standalone SDK Manager Cancel Apply Gradle环境 下载 Gradle(版本号2.14.1)包,配置 GRADLE HOME环境变量,将 GRADLE HOME/bin添加到PATH中 注意:由于 m PaaS Android框架的 Gradle插件是基于特定版本的 Android插件开 发的, Gradle版本之间互不兼容,所以需要安装 Gradle2.141版本。 配置完 GRADLE HOME之后需要配置 Android studio的 Preferences的 Gradle Home,其中路径使用本地的 Gradle2.14.1路径,如图: 吗蚁金融云版权所有Q2018 Android介绍 Build, Execution, Deployment Gradle s For current project Linked Gradle projects Keymap b Ediror Plugin Version Control T Bulld, Execution, Deployment P Debugger Compiler Use local gradle distribution Coverage Gradle home / Applications/Android Studio Gapp/ Contents/gradle/ gradle-2 14.1 equired Plugins P Languages Frameworks Offline work Service directory path: /Users/xunlongwxl/gradle Other Settings Cancel OK 配置 BOOST GRADLE HOME工具包环境,这是mPaS插件运行时所依赖的一些小工具。 下载 BOOST GRADLE HOME并解压到本地,配置 BOOST GRADLE HOME环境变量为 解压路径,并且将 BOOST GRADLE HOME路径添加到PATH环境变量。 安装插件 插件介绍 配置完环境之后即可安装 Android studio插件。每一个应用开发都应该安装该插件,插件不仅可以快速创建 m PaaS Android框架的工程,给 m PaaS android框架打包,还可以完成 mPaaS的必备功能,如:生成加密 图片(用于使用mPas的 Hotpatch、版本升级等功能时进行网络加密)、生成 Hotpatch包等 下载插件 使用金融云账户登录下载页面( ttps: //git. cloud alipay. com/mpaas/mPaaS_Androidaarblob/master/tools/boost_idea_mpaas 30. zip ),点击 Download下载 boost_idea_mpaas3_0.zjp插件。 安装插件 打开 Android studio的 Preferences> Plugins> Install plugin from disk选择刚下载的插件zp包,如下 图 吗蚁金融云版权所有Q2018 Android介绍 Preferences Appearance Behavior Show: All plugins v Sort by: name mPaaS Android Plugin Editor Plugins 此 IntelllLang X Uninstal Version Control Java Bytecode Decompiler Version: 1.0.0 Build, Execution, Deployment 的 JUnit mPaas Android idea插件 Languages Frameworks mPaS框架工程的打包可视化插件 Tools c mPaas Android Plugin Change Notes s Other Settings f: NDK Workspace Manager Support 1支持自定义命令 2支持快捷健打包 Plugin display name here Vendor s: Properties Support https:/wwwcloudalipaycnmfdocs/zn/AntcIoud/1845 SDK Updater xunong.wxl@alipay.com 的 Settings Repository r Subversion Integration s. Task Management e Terminal Test Recorder TestNG-J k or uncheck a plugin to enable or disable it Install JetBrains plugin Browse repositories Install plugin from disk. 下一步 参考mPaS插件以详细了解插件的各个功能 参考快速开始快速接入 m PaaS功能。 2 mPaas插件 插件详解 mPaaS包含了一个开发框架和众多的组件。如果开发新的App,可以考虑直接使用mPaS框架,可以帮助实 现多团队协作开发,使App自动具备埋点,长连接等功能,可以更方便快速的集成组件。当然组件和框架之间 没有强依赖,如果只想在已有应用中添加某个组件功能,比如升级,那可以只集成这个组件。 根据不同的接入方式,mPaS插件提供相应的工具帮助开发者使用mPaS开发的功能,包括新建 mPaaS工 程,添加、删除和升级 m Paas组件,工程打包,重签名,埋点日志解析等 Android studio插件有些功能是 m PaaS Android框架才会使用(功能介绍中已标注:mPaS Android框架使用),关于 m PaaS android框架具体请参考 m PaaS Android介绍文档。 安装完插件之后会在 Android studio工具栏中出现mPaS选项卡,点击该选项卡之后如下图所示 吗蚁金融云版权所有Q2018 Android介绍 Build-打包编译( m Paas Android框架使用) 使用打包功能之前,先确保已经配置了 Build Setting 编译 Bundle,以便在编译 Porta时可以找到这个 Bundle。编译时,需要在mPaS插件中点击Buid。 Build按钮类似于执行了 Gradle命令 gradle clean buildDebug(或者 buildRelease,取决于 settings 配置的是否为 debug包) 编译完成之后打出的 Bundle的包默认放在m2目录下。 MaC默认路径~/m2/ repository Windows默认路径c/ Users,/x/,m2 repository 注:可改变默认路径,在m2下面创建 settings.xm,把 localRepository修改成希望存储的位置,内容 如下 <?xml version ="1.0"encoding=UTF-8"?> settings xmins=htTp: //maven. apache org/settings/1.0.0 xminsxsi="http://www.w3.org/2001/xmlschema-instance xsi:schemalocation="http://maven.apacheorg/settings/1.0.0http://maven.apacheorg/xsd/settings-1.0.0.xsd"> <localRepository >/Users/your Name/ m2/repository </local Repository> <pluginGroups> </plugin Groups> ≤ proxIes> </proxies> </servers> <mirrors> </mirrors> ≤ profiles> </profiles> </settings> Run-运行Pora工程( mPaas android框架使用) 吗蚁金融云版权所有Q2018 Android介绍 编译 Porta,编译完成之后会弹出安装框,如下图所示 Run按钮类似于执行了 Gradle命令 Gradle clean fastDebug(或者 assemblerelease,取决于 settings配置的是否为 debug包) HotSwap-热部署〔 mPaaS Android框架使用) HotSwap功能类似于 Android原生的 Instance run。 hotSwap热部署 Bundle,仅支持 debug模式,对应命令如下 Gradle clean hotSwap Debug 注意如果使用 hotSwap必须保证 Portal的依赖中有 devbundle"comalipay. Android. phone. devtool: hotswap: 2.1.0.161103185423 @jar devmanifest"com alipay Android phone. devtool: hotswap: 2.1.0.161103185423: Android Manifest(@xml Build Setting-配置打包参数( mPaas android框架使用,必须) 配置打包参数: 配置 BOOST GRADLE HOME工具包咯径,如果已经配置了,点击OK按钮。 配置 Portal Launcher path,改路径配置成 portal的主 module路径,比如 xXX/portalPath/app,这个路径是使用Run(一键运行 porta)按钮时使用的路径。 是否是 debug模式 配置打包时默认添加的参数有- stacktrace-Plg=true Clean cache删除 Gradle插件的所有缓存数据 Generate Hotpatch-生成 Hotpatch 使用 Hotpatch-热修复能力,首先要让App具备热修复的能力,具体请参考热修复。 吗蚁金融云版权所有Q2018 6 Android介绍 集成mPaS有以下方式 在原生工程中直接集成 m Paas组件,不使用 m Paas框架 直接使用 m Paas框架,然后在框架中使用组件。 针对以上不同的集成方式,生成热修复包所选择的包有所不同: 对于原生工程的情况,需要两个不同的apk(一个是有bug的线上apk,一个是修复之后打出的 apk)根据代码的df生成path包。 New bundle处填写新apk包的本地地址, old bundle处 填写老的apk包的本地地址 对于 m PaaS Android框架的情况,需要两个不同的 bundle包(一个是已使用的有bug的 bundle 包,一个是修复之后打出的 bundle包, bundle的输出路径为 bundle的主 module目录下的 buld/ intermediates/ bundle/ XXXX-raw ar,如果是 release包则没有-raw)。 其中 New bundle:选择修复bug的包路径。 old bundle:选择有bug的包路径。 Path file dir:翰出的 patch包路径。 然后,输入签名信息生成热修复包,生成 Hotpatch包所需要的签名文件必须和运行的apk的签名文件保持一 致(与生成图片选择的apk的签名文件也要保持一致),生成的图片需要放在Pota工程的res/ drawable文 件夹下面,命名为yW1222jpg。 Mo rmm assort Generate YWJpg( Private)-生成 mPaas私有化部署的加密图片 因为加密图片与apk的签名文件有绑定关系,所以要生成加密图片,需要签名之后的apk文件,而且加密图片 只能用在该apk工程中。生成加密图片的步骤如下 注意:如果有多个签名,需要针对不同的签名文件生成不同的加密图片。 点击 Release Apk最右侧的…,选择 Porta工程签名之后的apk文件。此时RSA会自动填充 点击 manifestfile最右侧的….,选择 Portal工程的 Android Manifest xn文件,此时 work Spaced appld packageName会自动填充。如果没有,可以根据工程的 config文件中的配 置填写到对应输入框中。 吗蚁金融云版权所有Q2018 【实例截图】
【核心代码】