1. Android Studio 下载地址： OR Android Studio中文社区
  3. App离线SDK下载：最新android平台SDK下载

选择 Empty Activity 点击 Next。

avatar

Minimum API Level 建议选19及以上

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

点击 Finish 完成创建。

注意：App离线SDK不支持Kotlin

方式二：导入工程

2.7.0之后提供HBuilder-Integrate-AS工程，可以直接导入HBuilder-Integrate-AS工程，直接运行simpleDemo项目即可。

  1. 基础库配置

    • 5+APP

      将lib.5plus.base-release.aar、android-gif-drawable-release@1.2.17.aar和miit_mdid_1.0.10.aar拷贝到libs目录下

      在build.gradle中添加资源引用

      2. implementation 'com.github.bumptech.glide:glide:4.9.0' // 基座依赖
      3. implementation 'com.android.support:support-v4:28.0.0'
      4. implementation 'com.alibaba:fastjson:1.1.46.android'

    • uni-app

      将lib.5plus.base-release.aar、android-gif-drawable-release@1.2.17.aar、uniapp-release.aar和miit_mdid_1.0.10.aar拷贝到libs目录下

      avatar

      在build.gradle中添加资源引用

      1. aaptOptions {  
      2.   additionalParameters '--auto-add-overlay'  
      3.   ignoreAssetsPattern "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"

      注意：更新SDK时需要同时更新aar/jar文件和build.gradle配置

  2. 应用配置

    • 配置应用版本号

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

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

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

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

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

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

    • 配置应用名称

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

    • 配置应用启动页

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

      1.   <activity
      2.       android:name="io.dcloud.PandoraEntry"
      3.       android:configChanges="orientation|keyboardHidden|keyboard|navigation"
      4.       android:label="@string/app_name"
      6.       android:hardwareAccelerated="true"
      7.       android:theme="@style/TranslucentTheme"
      8.       android:screenOrientation="user"
      9.       android:windowSoftInputMode="adjustResize" >
      10.       <intent-filter>
      11.           <action android:name="android.intent.action.MAIN" />
      12.           <category android:name="android.intent.category.LAUNCHER" />
      13.       </intent-filter>
      14.   </activity>
      15.   <activity
      17.       android:configChanges="orientation|keyboardHidden|screenSize|mcc|mnc|fontScale|keyboard"
      18.       android:hardwareAccelerated="true"
      19.       android:permission="com.miui.securitycenter.permission.AppPermissionsEditor"
      20.       android:screenOrientation="user"
      21.       android:theme="@style/DCloudTheme"
      22.       android:windowSoftInputMode="adjustResize">
      23.       <intent-filter>
      24.           <category android:name="android.intent.category.DEFAULT" />
      25.           <category android:name="android.intent.category.BROWSABLE" />
      26.           <action android:name="android.intent.action.VIEW" />
      27.           <data android:scheme="h56131bcf" />
      29.   </activity>

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

      • 图标名称

        icon.png为应用的图标。

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

  1. 资源配置

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

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

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

      avatar

      注意：dcloud1.dat、dcloud2.dat为uni-app所需资源（2.7.0之后已不在需要，升级时需要删除，可以减少apk大小），5+APP可将这两个文件删除。

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

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

      将HBuilderX中的项目导出，将导出的资源复制到assets->apps下，如下图所示：

      导出app资源

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

avatar