如果采用 组件化接入方式,您需要完成以下通用步骤以完成接入流程:
本文将以 Windows 开发环境为例,引导您在本地创建一个全新 App,并编译打包,最终获得可运行的 .apk
包。
您首先需要:
如果您需要组件化方案,可以使用 Portal Bundle 方式,您首先需要创建一个 Portal 工程。
Portal 一般不包含业务代码,仅仅用于将各 Bundle 合并成一个可运行的 .apk
包。因此在创建 Portal 时,默认会创建一个后缀名为 Launcher
的 Bundle 工程。
具体创建步骤如下:
启动 Android Studio 后,在欢迎页面点击 Start a new mPaaS project。
在 Create New mPaaS Project 窗口中,选择 mPaaS Portal。点击 Next。
填写 项目名称,在 控制台配置文件(JSON)路径选择 中选择从控制台 代码管理 > 代码配置 中下载到的 .config 配置文件,mPaaS 插件会根据选择的配置文件自动解析填写 Package Name 。点击 Next。
选择 mPaaS SDK 版本,并勾选您需要的模块依赖。点击 Next 按钮。
确认默认创建的 Bundle 工程的信息。点击 Finish 按钮。
至此,您已完成 Portal 工程的创建,并同时获得一个默认创建的 Bundle 工程。
mPaaS 框架支持多 Bundle,您可以为您的工程添加多个 Bundle 工程。
点击 File > New > Start a New mPaaS Project 菜单。
在 Create New mPaaS Project 窗口中,选择 mPaaS Portal。点击 Next。
填写 项目名称,在 控制台配置文件(JSON)路径选择 中选择从控制台 代码管理 > 代码配置 中下载到的 .config 配置文件,mPaaS 插件会根据选择的配置文件自动解析填写 Package Name 。点击 Next。
选择 mPaaS SDK 版本,并勾选您需要的模块依赖。点击 Next 按钮。
确认默认创建的 Bundle 工程的信息。点击 Finish 按钮。
至此,您已完成 Bundle 工程的创建。关于 Bundle 开发的更多信息,请参见 Bundle 工程。
您可以参考各组件的接入文档,接入并使用 mPaaS 组件。
组件化接入方式 > 简介:介绍 Portal 和 Bundle 工程的代码结构、编译打包结果以及与原生工程的区别。
为了使用 mPaaS 组件,您需要分别在 Portal 和 Bundle 工程中添加对应组件的依赖:
在 Android Studio 中选择 mPaaS > 组件化接入,在弹出的接入面板中,点击 配置/更新组件 下的 开始配置。
如果您此前未使用过 Android Studio mPaaS 插件管理组件依赖,是您首次使用 组件管理 功能添加完组件后,您还需要检查或修改以下配置。
build.gradle
文件,确保包含以下依赖且不低于以下版本:
buildscript {
...
dependencies {
classpath 'com.android.boost.easyconfig:easyconfig:2.4.3'
}
}
build.gradle
文件,确保包含以下内容:
apply plugin: 'com.alipay.portal'
portal {
allSlinks true
mergeAssets true
}
apply plugin: 'com.alipay.apollo.baseline.update'
mpaascomponents{
excludeDependencies=[]
}
build.gradle
文件中删除 dependencies 节点下 mPaaS 组件相关依赖(mpaas-baseresjar
除外)。build.gradle
文件中删除以下内容:并删除工程根目录下的
apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_bundles.gradle"
apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_apis.gradle"
mpaas_bundles.gradle
和 mpaas_apis.gradle
文件,但需要注意,删除 mpaas_apis.gradle
文件可能导致编译失败,您需要按照下文在子 module 中修改配置。build.gradle
文件中添加:
apply plugin: 'com.alipay.apollo.baseline.update'
build.gradle
文件中删除:并添加:
apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_apis.gradle"
apply plugin: 'com.alipay.apollo.baseline.update'
build.gradle
文件中的 dependencies 节点下,例如:
bundle 'com.alipay.android.phone.mobilesdk:logging-build:2.0.2.180322162837@jar'
manifest 'com.alipay.android.phone.mobilesdk:logging-build:2.0.2.180322162837:AndroidManifest@xml'
使用 Android Studio mPaaS 插件提供的 构建 功能编译工程。
在文档使用中是否遇到以下问题
更多建议
匿名提交