如何用JavaFX创建可成功导出的Android应用？（VS Code环境）

目前JavaFX本身没有原生的Android支持，主流方案是借助Gluon Mobile工具链实现跨平台打包，以下是针对VS Code环境的具体步骤：

1. 准备依赖工具 #

• 在VS Code扩展市场安装「Gluon Tools」插件，它提供了JavaFX跨平台打包的Gradle配置支持。
• 确保本地安装JDK 11+（推荐JDK 17 LTS），并正确配置JAVA_HOME环境变量。
• 安装Android SDK：可以通过Android Studio的SDK Manager下载，也可以用Gluon插件自动拉取。配置ANDROID_HOME环境变量，将$ANDROID_HOME/platform-tools和$ANDROID_HOME/tools加入系统PATH。

2. 创建/改造JavaFX项目 #

新建适配项目 #

直接通过Gluon Tools插件创建「Gluon Mobile Project」，选择Single View模板，项目会自动生成Android适配的Gradle配置和目录结构。

改造现有JavaFX项目 #

如果是已有的JavaFX项目，需要修改build.gradle文件：

• 引入Gluon插件：

  plugins {
      id 'java'
      id 'application'
      id 'com.gluonhq.client-gradle-plugin' version '1.0.17'
  }
  

• 添加Gluon依赖：

  dependencies {
      implementation 'org.openjfx:javafx-controls:17.0.6'
      implementation 'com.gluonhq:charm:6.2.0'
  }
  

• 配置Android打包参数：

  client {
      target = 'android'
      android {
          manifest = file('src/android/AndroidManifest.xml')
          compileSdkVersion = 33
          minSdkVersion = 21
          targetSdkVersion = 33
      }
      mainClass = '你的主类全路径'
  }
  

  同时在项目根目录创建src/android文件夹，放入AndroidManifest.xml，示例配置：

  <?xml version="1.0" encoding="utf-8"?>
  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.yourpackage.app">
      <application
          android:allowBackup="true"
          android:icon="@mipmap/ic_launcher"
          android:label="@string/app_name"
          android:roundIcon="@mipmap/ic_launcher_round"
          android:supportsRtl="true"
          android:theme="@style/AppTheme">
          <activity
              android:name="com.gluonhq.helloandroid.MainActivity"
              android:label="@string/app_name"
              android:configChanges="orientation|keyboardHidden|screenSize">
              <intent-filter>
                  <action android:name="android.intent.action.MAIN" />
                  <category android:name="android.intent.category.LAUNCHER" />
              </intent-filter>
          </activity>
      </application>
  </manifest>
  

3. 调试与打包 #

• 调试运行：连接开启USB调试的Android设备，或启动Android模拟器，在VS Code终端执行：

  ./gradlew androidInstall
  

  命令完成后，应用会自动安装到设备并启动。
• 打包APK：执行以下命令生成发布版APK：

  ./gradlew androidPackage
  

  生成的APK文件位于build/client/android/<架构>/release目录下（架构一般为x86_64或arm64-v8a）。

4. 关键注意事项 #

• 避免使用JavaFX桌面专属API（如SystemTray、Desktop），优先使用Gluon Charm提供的跨平台组件（如MobileApplication、View）。
• 根据应用需求在AndroidManifest.xml中声明必要权限，比如存储访问、相机调用等。
• 优化性能：减少复杂动画的过度使用，对图片等资源进行压缩，采用懒加载策略降低内存占用。

内容的提问来源于stack exchange，提问作者Sayon Mitra