如何从路径导入JavaFX Ports至Android Studio及相关配置问题

一、是否需要添加全部三个文件夹？ #

不需要全部放入Android Studio项目，三个文件夹的作用及处理方式如下：

• android-tools：属于编译打包工具集，无需放入项目，只需确保其路径被gradle脚本识别（可通过配置环境变量或在gradle中指定绝对路径）。
• lib：包含对应不同CPU架构的本地库（.so文件），必须按架构分类放入项目的src/main/jniLibs目录（比如armeabi-v7a、x86子目录分别对应不同设备架构），不能直接复制到libs目录。
• rt：JavaFX运行时jar包，需将其中的.jar文件复制到项目的libs目录，后续在gradle中引入依赖。

二、正确的build.gradle（模块级）配置 #

1. 引入rt目录的jar包依赖

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    // 其他项目依赖...
}

2. 配置JNI库路径与架构过滤（解决x86_64报错的核心）

android {
    compileSdkVersion 23 // 匹配Android 6.0.1版本
    defaultConfig {
        applicationId "com.example.fx_appfragment"
        minSdkVersion 23
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
        
        // 指定支持的CPU架构，排除x86_64（dalvik-sdk无该架构库）
        ndk {
            abiFilters 'armeabi-v7a', 'x86'
        }
    }
    
    // 指定JNI库目录路径
    sourceSets {
        main {
            jniLibs.srcDirs = ['src/main/jniLibs']
        }
    }
    
    // 匹配JavaFX要求的Java版本
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

3. 添加JavaFX Ports插件配置（若未添加）

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'org.javafxports:jfxmobile-plugin:1.3.15'
    }
}

apply plugin: 'org.javafxports.jfxmobile'

jfxmobile {
    android {
        // 填写本地dalvik-sdk下android-tools的绝对路径
        androidSdk = '/path/to/your/dalvik-sdk/android-tools'
    }
}

三、MainActivity配置 #

MainActivity需继承FXActivity，而非普通的AppCompatActivity，并正确初始化JavaFX界面：

import javafxports.android.FXActivity;
import javafx.scene.Scene;
import javafx.scene.layout.StackPane;
import javafx.scene.text.Text;
import javafx.application.Platform;
import android.os.Bundle;

public class MainActivity extends FXActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 异步初始化JavaFX界面，避免阻塞主线程
        Platform.runLater(() -> {
            Text text = new Text("Hello JavaFX on Android");
            StackPane root = new StackPane(text);
            Scene scene = new Scene(root, 300, 200);
            setScene(scene);
        });
    }
}

四、问题排查与解决 #

1. 三星Galaxy S5真机黑屏

   • 检查jniLibs目录下是否存在armeabi-v7a架构的.so文件（S5为该架构），缺失会导致JavaFX无法启动。
   • 确认MainActivity中是否调用setScene()方法加载JavaFX场景，未加载场景会显示黑屏。
   • 检查libs目录下的JavaFX运行时jar包是否全部引入，缺失核心jar包会导致初始化失败。

2. Pixel Api_23虚拟设备报错x86_64库异常

   • dalvik-sdk未提供x86_64架构的本地库，需创建x86架构的虚拟设备（而非x86_64）。
   • 或在gradle的abiFilters中明确排除x86_64，只保留x86架构，确保虚拟设备与库架构匹配。

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