Hbuilder离线打包

开发环境

  1. Android Studio 下载地址:Android Studio官网 OR Android Studio中文社区
  2. HBuilderX
  3. App离线SDK下载:最新android平台SDK下载

准备工程

新建工程

打开Android studio新建一个空白项目

选择 Empty Activity 点击 Next。

Minimum API Level 建议选19及以上

Package name作为应用标志,涉及申请第三方平台账号,一般情况下不建议修改,包名一般设置反向域名,如:io.dcloud.HBuilder

如果在线打包过,使用一致的包名

点击 Finish 完成创建。

配置工程

  1. 基础库配置

    • 5+APP

      将lib.5plus.base-release.aar、android-gif-drawable-release@1.2.17.aar和miit_mdid_1.0.10.aar(HBuilderX2.8.1之后更新到msa_mdid_1.0.13.aar)拷贝到libs目录下

      avatar

      在build.gradle中添加资源引用

      implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'], exclude: [])
      implementation 'com.github.bumptech.glide:glide:4.9.0' // 基座依赖
      implementation 'com.android.support:support-v4:28.0.0'
      implementation 'com.alibaba:fastjson:1.1.46.android'
    • 模块配置

      依赖库配置

      参考“Feature-Android.xls”文档确定应用中使用到的扩展API,拷贝libs目录中对应的“jar或aar”文件拷贝到工程的app->libs目录下,如使用地图功能,需将下图“jar包”列对应的文件拷贝到libs目录下。此处以高德地图为例。

      avatar

      添加应用权限

    •    配合HTML5+ SDK,需要添加如下权限:

      <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>
      
      <uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT"/>
      
      <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>
      
      <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
      
      <uses-permission android:name="android.permission.READ_CONTACTS"/>
      
      <uses-permission android:name="android.permission.GET_TASKS"/>
      
      <uses-permission android:name="android.permission.VIBRATE"/>
      
      <uses-permission android:name="android.permission.READ_LOGS"/>
      
      <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
      
      <uses-feature android:name="android.hardware.camera.autofocus"/>
      
      <uses-permission android:name="android.permission.WRITE_CONTACTS"/>
      
      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
      
      <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
      
      <uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT"/>
      
      <uses-permission android:name="android.permission.CAMERA"/>
      
      <uses-permission android:name="android.permission.GET_ACCOUNTS"/>
      
      <uses-permission android:name="android.permission.RECORD_AUDIO"/>
      
      <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>
      
      <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
      
      <uses-permission android:name="android.permission.SEND_SMS"/>
      
      <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
      
      <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
      
      <uses-permission android:name="android.permission.WAKE_LOCK"/>
      
      <uses-permission android:name="android.permission.CALL_PHONE"/>
      
      <uses-permission android:name="android.permission.FLASHLIGHT"/>
      
      <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
      
      <uses-feature android:name="android.hardware.camera"/>
      
      <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
      
      <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT"/>
      
      <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION"/>
      
      <uses-permission android:name="android.permission.WRITE_SETTINGS"/>
      
      <uses-permission android:name="android.permission.WRITE_SMS"/>
      
      <uses-permission android:name="android.permission.READ_SMS"/>
      如上权限为lib.5plus.base-release.aar包所必须的权限,如果引入了其他aar包,还需额外引入其他权限,详见SDK里的Feature-Android.xls文档。

      参考“Feature-Android.xls”文档的“AndroidManifest.xml permission”列,将需要配置的模块的权限拷贝到对应项目的Androidmanifest.xml中,如下图。

      avatar

      dcloud_properties.xml 配置

      参考“Feature-Android.xls”文档的“properties.xml文件配置”列,将需要配置的模块的features节点和services节点拷贝到dcloud_properties.xml(路径详看下面资源配置)中,如下图。

      avatar

      添加第三方应用信息

      参考“Feature-Android.xls”文档的“AndroidManifest.xml Application节点”列,将需要配置的模块的节点拷贝到对应项目的Androidmanifest.xml中并修改对应的应用信息,如下图。

      avatar

  2. 应用配置

    • 配置应用版本号

      avatar

      versionCode为应用的版本号(整数值),用于各应用市场的升级判断,建议与manifest.json中version -> code值一致

      versionName为应用的版本名称(字符串),在系统应用管理程序中显示的版本号,建议与manifest.json中version -> name值一致。

      applicationId为应用的包名,一般设置为反向域名,不建议修改。

      建议将targetSdkVersion设置为25或以上。

      App离线SDK minSdkVersion最低支持19,小于19在部分4.4以下机型上将无法正常使用。

      完整版build.gradle可参考如下内容。

      apply plugin: 'com.android.application'
      
      android {
        compileSdkVersion 28
        defaultConfig {
            applicationId "com.example.myapplication"
            minSdkVersion 19
            targetSdkVersion 28
            versionCode 1
            versionName "1.0"
            multiDexEnabled true
        }
        buildTypes {
            release {
                minifyEnabled false
                proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            }
        }
      }
      
      dependencies {
        implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'], exclude: [])
        implementation 'com.github.bumptech.glide:glide:4.9.0' // 基座依赖
        implementation 'com.android.support:support-v4:28.0.0'
        implementation 'com.alibaba:fastjson:1.1.46.android'
      }Copy to clipboardErrorCopied
    • 配置应用名称

      values -> strings.xml文件,修改“app_name”字段值,该值为安装到手机上桌面显示的应用名称,建议与manifest.json中name(基础配置中的应用名称)对应。

    • 配置应用启动页及provider节点

      将下述内容添加到Androidmanifest.xml的application节点中

      注意:新建的项目默认会有一个MainActivity的节点,必须删掉!

        <activity
            android:name="io.dcloud.PandoraEntry"
            android:configChanges="orientation|keyboardHidden|keyboard|navigation"
            android:label="@string/app_name"
            android:launchMode="singleTask"
            android:hardwareAccelerated="true"
            android:theme="@style/TranslucentTheme"
            android:screenOrientation="user"
            android:windowSoftInputMode="adjustResize" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <activity
            android:name="io.dcloud.PandoraEntryActivity"
            android:launchMode="singleTask"
            android:configChanges="orientation|keyboardHidden|screenSize|mcc|mnc|fontScale|keyboard"
            android:hardwareAccelerated="true"
            android:permission="com.miui.securitycenter.permission.AppPermissionsEditor"
            android:screenOrientation="user"
            android:theme="@style/DCloudTheme"
            android:windowSoftInputMode="adjustResize">
            <intent-filter>
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <action android:name="android.intent.action.VIEW" />
                <data android:scheme="h56131bcf" />
            </intent-filter>
        </activity>
        <!--provider节点必须添加-->
        <provider
            android:name="io.dcloud.common.util.DCloud_FileProvider"
            android:authorities="${apk.applicationId}.dc.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/dcloud_file_provider" />
        </provider>

      注意:${apk.applicationId} 必须替换成当前应用的包名

    • 配置应用图标和启动界面

      将icon.png、push.png、splash.png放置到drawable,drawalbe-ldpi,drawable-mdpi,drawable-hdpi,drawable-xhdpi,drawable-xxhdpi文件夹下,不同文件夹下对应不同图片尺寸,可参考文档

      avatar

      修改Androidmanifest.xml中application节点的icon属性为@drawable/icon。如下图:

      avatar

      注意:splash.png在不同设备上显示效果不一样,为防止出现拉伸的状况,建议使用Android studio生成.9.png类型图片,可参考文档

      • 图标名称

        icon.png为应用的图标。

        push.png为推送消息的图标。

        splash.png为应用启动页的图标。

  3. 资源配置

    Android studio默认项目没有assets文件夹,需手动创建,创建位置与java目录同级。

  • 创建data文件夹并拷贝资源

    将SDK->assets->data文件夹拷贝到刚刚创建的assets文件夹下,如下图:

    注意:SDK升级时,data下资源需要同时更新。

  • 创建apps文件夹并拷贝资源

     将HBuilderX中的项目导出

         

         将导出的资源复制到assets->apps下,如下图所示:

        

 

  • 修改dcloud_control.xml文件

    修改dcloud_control.xml中的appid为拷贝过来的5+APP的id,确保dcloud_control.xml中的appid与manifest.json中的id与文件夹名一致,如下图所示:

    avatar

    生成自定义基座,需要在根节点下添加debug="true"和syncDebug="true",如下图:

    自定义基座支持热更新需要将debug-server-release.aar打入apk中,生成正式包时可以删除。

运行

连接手机,点击按钮,运行即可。

打包

在菜单栏中选择Build,点击Generate Signed Bundle /APK...项,进入打包页面。

打包选择签名文件,可以参考hbuilder教程里面,如何生成

V1属于旧的验证方式,V2是在安卓版本7.0之后新的验证方式,只勾选V1在Android7.0以上不会使用更安全的验证方式,如果只勾选V2那么安卓版本7.0以下的手机将无法正常安装,所以建议V1和V2同时勾选

 

问题

解决方法:

参考:

https://nativesupport.dcloud.net.cn/AppDocs/usemodule/android

https://nativesupport.dcloud.net.cn/AppDocs/download/android

https://www.jianshu.com/p/b7eefa1cadcc

https://blog.csdn.net/yafo00/article/details/98844535

  • 1
    点赞
  • 8
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值