使用gluonfx-gradle-plugin打包Android时遇AndroidManifest无效包名错误

问题原因 #

IntelliJ的Gluon模板项目默认配置存在疏漏，生成的包名以点开头（.GluonSingleViewProject），不符合Android包名命名规范——必须由小写字母、数字和点组成，不能以点开头，建议采用反向域名格式。GluonFX插件自动生成AndroidManifest.xml时，会从项目的mainClassName或插件配置的packageName推导包名，模板未正确配置这两项导致了错误。

解决步骤 #

1. 在build.gradle中明确配置合法包名 #

打开项目根目录的build.gradle文件，找到或添加gluonfx扩展配置块，指定符合Android规范的包名，示例如下：

gluonfx {
    target = 'android'
    // 替换为你自己的合法包名，比如com.yourdomain.projectname
    packageName = 'com.example.gluonsingleview'
    // 确保主类全限定名正确，无前置点
    mainClassName = 'com.example.gluonsingleview.GluonSingleViewProject'
}

2. 修正主类全限定名 #

如果原mainClassName配置是.GluonSingleViewProject（带前置点），必须改为完整的全限定类名——包含合法的包前缀，这是插件推导包名的核心依据之一。

3. 清理并重新执行打包任务 #

先清理之前生成的无效缓存文件，再执行打包任务：

# Linux/Mac环境
./gradlew clean gluonfxNativePackage

# Windows环境
gradlew clean gluonfxNativePackage

额外说明 #

• GluonFX插件生成AndroidManifest.xml时，优先读取gluonfx扩展里的packageName配置；如果未设置，会自动从mainClassName中提取包路径部分。
• Android包名是应用的唯一标识，一旦发布无法修改，建议提前规划好符合规范的命名格式。

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