uniapp 开发android 之hbuildx 离线打包 app 项目实战教程

在使用HBuilderX进行uniapp的Android离线打包时，如何正确配置本地SDK和gradle环境？按照教程操作后总是提示NDK路径错误，但实际路径已确认无误。另外，离线打包后的APK体积比云打包大很多，应该如何优化资源文件？求详细的项目配置步骤和常见问题解决方案。

2 回复

使用HBuilderX离线打包UniApp安卓应用步骤：

  1. 下载Android Studio和对应SDK
  2. 获取AppKey，配置manifest.json
  3. 导入原生工程到Android Studio
  4. 替换资源文件，配置应用参数
  5. 生成签名文件并打包APK

注意：需提前安装Java环境，配置gradle依赖。


Uniapp Android 离线打包实战教程

环境准备

  1. Android Studio：安装最新版本
  2. HBuilderX：确保是最新版本
  3. SDK：配置Android SDK环境变量
  4. 离线SDK：从DCloud官网下载对应版本

步骤详解

1. 创建Android工程

在Android Studio中创建新项目，选择Empty Activity。

2. 导入离线SDK

将下载的离线SDK中的以下文件复制到项目对应位置：

  • uniapp-v8-release.aar → app/libs/
  • 其他依赖库aar文件

3. 配置build.gradle

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
    implementation 'androidx.appcompat:appcompat:1.3.0'
    implementation 'com.google.android.material:material:1.4.0'
    // 添加其他必要依赖
}

4. 修改AndroidManifest.xml

添加必要的权限和Activity配置：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<activity
    android:name="io.dcloud.PandoraEntry"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|mcc|mnc|locale|layoutDirection"
    android:hardwareAccelerated="true"
    android:launchMode="singleTask"
    android:theme="@style/AppTheme"
    android:windowSoftInputMode="adjustResize">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

5. 初始化Uniapp

在MainActivity中：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        // 初始化SDK
        SDKInitEngine.init(this);
        
        // 启动Uniapp
        Intent intent = new Intent(this, PandoraEntry.class);
        startActivity(intent);
        finish();
    }
}

6. 放置资源文件

将HBuilderX打包生成的apps文件夹复制到assets/apps/目录下。

7. 配置应用信息

在assets/data/dcloud_control.xml中配置appid等信息。

8. 打包生成APK

在Android Studio中选择Build → Generate Signed Bundle / APK，按提示操作即可。

注意事项

  1. 确保离线SDK版本与HBuilderX版本匹配
  2. 检查所有依赖库是否完整
  3. 配置正确的应用签名
  4. 测试各项功能是否正常

完成以上步骤后，即可成功生成离线打包的Android应用。

回到顶部