Android平台App支持CPU类型配置说明

此文档不再维护，请参考新文档地址：https://uniapp.dcloud.io/tutorial/app-android-abifilters

HBuilderX2.7.0+ 调整云端打包默认不再包含 x86 CPU类型库，减少apk包体积详情

HBuilderX2.1.5+ 开始支持Android平台的新增适配64位CPU类型，云端打包支持配置App支持的CPU类型
满足Google Play从2019年8月1日起上传的App必需支持64位CPU的要求。
不管5+App、wap2app、uni-app的各种编译模式，均已支持。
上一代HBuilder不支持，请升级更新为HBuilderX。

概要

Android平台配置CPU类型针对的是为了提高运行效率使用C/C++语言开发生成的so库，需要为各cpu类型平台单独编译生成对应指令的so库。Java语言开发的代码运行在虚拟机中，由虚拟机适配CPU类型，不涉及到此问题。

HBuilder/HBuilderX中使用so库的功能（模块）

Audio（录音）：支持mp3格式
Geolocation（定位）：百度
LivePush（直播推流）
Maps（地图）：高德、百度
OAuth（登录鉴权）：新浪微博
Push（消息推送）：个推、UniPush
Share（分享）：新浪微博
Speech（语音输入）：百度，注意：讯飞不支持64位
Weex（原生渲染）：uni-app（自定义组件模式、nvue页面）， 注意：HBuilderX2.1.5及以上版本支持

CPU类型

目前HBuilder/HBulderX适配支持以下主流CPU类型：

armeabi-v7a
第7代及以上的ARM处理器（ARM32位），市面上大多数手机使用此CPU类型。
arm64-v8a
第8代、64位ARM处理器（ARM64位），最近两年新发的设备使用此CPU类型，可以兼容使用armeabi-v7a的so库。
x86
少部分平板使用x86，AS模拟器中选了intel x86时使用x86处理器，以及其它常用三方模拟器通常使用x86

注意：不勾选x86在模拟器上可能无法正常运行，以下是常见模拟器是否需要包含x86的情况

雷电模拟器：
3.x必须包含x86，否则无法正常运行；4.x无需包含x86。
夜神模拟器：
必须包含x86，否则无法正常运行
MuMu模拟器：
无需包含x86
逍遥模拟器：
无需包含x86
BlueStacks（蓝叠模拟器）：
无需包含x86
腾讯模拟器（手游助手）：
必须包含x86，否则无法正常运行
其它模拟器：
未测试验证，建议包含x86，确保在模拟器正常运行

云端打包配置

可视化界面配置

打开项目的manifest.json文件，切换到“App常用其它设置”页面，勾选需要支持的cpu类型：

源码视图配置

打开项目的manifest.json文件，切换到“源码视图”
5+APP项目在 "plus" -> "distribute" -> "google" -> "abiFilters"，uni-app项目在 "app-plus" -> "distribute" -> "android" -> "abiFilters" 添加要支持的CPU类型：

"abiFilters":[  
    "armeabi-v7a",  
    "arm64-v8a"  
],

在上面节点配置需要支持的cpu类型，不需要的删除即可，不设置此字段则默认使用armeabi-v7a（ARM32位）

提交Google Play时要求支持64位，请选择"armeabi-v7a"、"arm64-v8a"两个即可。不要勾选“x86”
保存后提交云端打包生效。

查看打包后插件apk支持的CPU类型

使用解压工具打开apk，在lib目录下可以查看到支持的CPU类型，如下图所示：

离线打包配置

配置CPU类型

使用Android studio打开Android原生项目，打开对应项目的build.gradle文件。
在Android -> defaultConfig下添加支持的CPU类型，如下示例：

defaultConfig{  
    ndk {  
            abiFilters 'arm64-v8a','armeabi-v7a'  
        }  
}

注意：离线打包仅支持arm64-v8a、armeabi-v7a、x86三种类型，建议根据自己需求选择打包的CPU类型

CPU类型选择建议

ARM64位（arm64-v8a）CPU可以兼容ARM32的指令，也就是说只选择armeabi-v7a类型的so库也可以在64位手机上运行，只是没有完全发挥CPU的性能。
选择支持的CPU类型时请参考以下建议：

如果不在意apk大小，三种CPU类型都勾选
如果在意apk大小，选择ARM32位即可（几乎在所有ARM指令的所有设备上都可正常运行）
如果要兼容一些平板和模拟器，选择ARM32位和X86
不是所有模拟都仅支持x86指令，如雷电（4.x）、MuMu等模拟器也是支持ARM指令。

CPU类型错误安装提示

如果打包选择的CPU类型与设备不兼容，会导致无法正常安装。
通过adb命令安装通常会提示如下错误：

Performing Streamed Install  
adb: failed to install android_debug.apk: Failure [INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries, res=-113]

使用Android Studio自带的x86模拟器，将不包含x86 cpu类型的apk拖到模拟器安装时会弹出如下提示框：