DEV Community

loading...
Cover image for Build Cross-Platform Native Mobile Apps using Java/Kotlin for iOS, Android, Desktop & Web
Codename One

Build Cross-Platform Native Mobile Apps using Java/Kotlin for iOS, Android, Desktop & Web

Shai Almog
Developer Advocate at Lightrun, Co-founder of Codename One, author, blogger and open source hacker
Originally published at Medium ・4 min read

The new Codename One Maven build makes building native mobile and desktop apps trivial… It’s also free and open source to boot!

We can get started by opening start.codenameone.com

Where we select the package name for our app. This is very important as it can’t be changed once the app is submitted to a store!

start.codenameone.com

We enter the name to the app and download a zip containing the maven project, notice that you need to pick Kotlin if you wish to build a Kotlin app…

We can now open the app in any IDE, I used IntelliJ/IDEA but you can use Eclipse, NetBeans, or even VSCode. Most of the important code in the project is under the common directory.

The project opened in IntelliJ/IDEA. Form creation highlighted

Right now it only has the main class under the package you selected which in my case is com.example.myapp. Let’s look at the start method within the main app which creates a hello world form.

Main Source code

This code creates a Form, which is the root component for a Codename One app, and shows it. It also adds a “Hello World” label under the “Hi World” title.

The maven target “Run in Simulator” lets us run the simulator and produces this result:

Simulator

There are many other maven targets we can use to do pretty much everything you will need and I will go through a few of them, but first I want to show off the ease of Codename One programming…

We can change the code above to this:

Changes in the source

We add a button called “sayHi” and add a listener to an event.

In the event callback we show a dialog. This is pretty intuitive and works exactly as you would expect…

Dialog showing after clicking the button

We can place a breakpoint, debug and even make changes to the code and see it update on the fly (this requires a bit of work but does in fact work). But one of the cooler things is the ease of styling.

theme.css enables styling the entire UI on the fly

Setting the button color to red in the css produces an instant change without recompiling, reloading or anything:

Results of styling the color to red

To build a native app we can select the appropriate target such as Android build, iOS, Mac Windows etc. This sends a build to Codename One servers which have all the tools installed and let you build iOS apps without a Mac. You can also generate a local build which I’ll below. Notice I’m simplifying a bit, since you also need a certificate. That’s a bit of a painful subject in general. Codename One makes that relatively simple with wizards etc. but that’s a bit of a big subject.

Sending a native build

You can track the results in three places, the first is the build cloud from where you can download the resulting file, scan the QR code to install it on the device, copy or email the link.

Cloud Build Results: https://cloud.codenameone.com/secure/index.html

The second way is through Codename One Settings which you can launch via maven too:

Launching Codename One Settings

This launches a desktop app that’s a “one stop shop” for controlling Codename One. You can define project settings, generate certificates, monitor builds etc.

Device Builds section of Codename One Settings AKA Control Center

There’s also a native Android app which you can use to track builds and install them. For iOS you can open the web URL which will work well on device.

Finally, we can build a native app without the build cloud. We can run the Xcode iOS project target or the Gradle Android Project maven target.

xcode ios project maven target

After running the Xcode project Apples Xcode environment launches seamlessly with the generated native iOS project which we can run in the native iOS simulator or on the device! Notice that this requires a Mac. The Android Studio equivalent works everywhere…

The native project in xcode

All of the above is also in this tutorial video if you prefer that:

Build Cross-Platform Native Mobile Apps using Java/Kotlin for iOS, Android, Desktop & Web

Final Note

Everything I wrote about is open source in our github project where we discuss a lot more. If you think we did a good job we could use your help in starring and promoting our work here.

If you have any questions please follow the codenameone tag on stackoverflow and ask anything with that tag. I make an effort to answer everything I can.

Discussion (1)

Collapse
atulbhattsystem32 profile image
Atul Bhatt

Not much into Android development but it's definitely something cool to try. Will give it a try someday.