Skip to content

HelloGluon sample including Github actions for automating builds and releases

License

Notifications You must be signed in to change notification settings

gluonhq/hello-gluon-ci

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HelloGluon CI

This sample shows how to automatically build a Gluon Application using Github Actions.

It uses a version of HelloGluon, a Hello World application with Java 23, JavaFX 24ea, Gluon Mobile and GraalVM. For more details about Gluon Applications in general, please have a look at the Gluon docs or the other samples.

This sample focuses on the continuous integration using Github Actions on these platforms:

  • Linux

  • MacOS (x86_64 and AArch64)

  • iOS

  • Android

  • Windows (not supported with latest 1.0.24 yet)

  • Embedded - AArch64 Linux (not supported with latest 1.0.24 yet)

All these platform specific workflows share these common steps:

  • Checkout your code
  • Setup the build environment, specific to the platform
  • Build the application
  • Upload the application

Next to the above steps, for iOS and Android, the workflow includes steps to properly sign and upload the binary to the Play Store and App Store.

Build setup

Building using Github Actions is not very different from building locally.

On top of a default Gluon application, the following releaseConfiguration was added to the maven-gluonfx-plugin configuration:

<configuration>
    <releaseConfiguration>
        <!-- for iOS -->
        <bundleVersion>${env.GITHUB_RUN_NUMBER}</bundleVersion>
        
        <!-- for Android -->
        <versionCode>${env.GITHUB_RUN_NUMBER}</versionCode>
        <providedKeyStorePath>${env.GLUON_ANDROID_KEYSTOREPATH}</providedKeyStorePath>
        <providedKeyStorePassword>${env.GLUON_ANDROID_KEYSTORE_PASSWORD}</providedKeyStorePassword>
        <providedKeyAlias>${env.GLUON_ANDROID_KEYALIAS}</providedKeyAlias>
        <providedKeyAliasPassword>${env.GLUON_ANDROID_KEYALIAS_PASSWORD}</providedKeyAliasPassword>
    </releaseConfiguration>
</configuration>

For iOS:

  • bundleVersion is set to the GITHUB_RUN_NUMBER, so each build will have unique CFBundleVersion. See this doc for more information.

For Android:

  • versionCode is set to the GITHUB_RUN_NUMBER, so each build will have a unique android:versionCode. See this doc for more information.
  • keystore configuration are taken from env variables, that will be set by the workflow action.

Gluon license

All workflows use this action this Gluon license action:

  - name: Gluon License
    uses: gluonhq/gluon-build-license@v1
    with:
      gluon-license: ${{ secrets.GLUON_LICENSE }}

Using a Gluon license is optional and depends on your situation. Have a look at the Gluon website for more information about licences or contact us.

Platforms

Github Action workflows are specified in .github/workflows and configured to be triggered on push. Depending on your own preference and requirements, this can of course be changed. Please refer to the GitHub Actions documentation for more information.

MacOS

MacOS x86_64

MacOS AArch64

Linux

Linux

iOS

iOS

Android

Android

Windows

Windows

Embedded - AArch64 Linux

AArch64 Linux

About

HelloGluon sample including Github actions for automating builds and releases

Resources

License

Stars

Watchers

Forks

Packages

No packages published