Making a cross-platform mobile game in Reason/OCaml

I launched the first cross-platform mobile native game written in Reason a few weeks ago :tada:, to the Android and iOS app stores , with a freeweb version and a macos desktop bundle (source code all on github ).

Getting there required lots of fiddling with cross-compilers and build systems, and so I made a tool that will take away much of the pain involved, so you can get started immediately and get your game into the world. NB: This is still super experimental but I’m really excited about it and want to get y’all in on the fun.

Platform note: I’ve only managed to set things up completely for macos so far – I’ve started on prebuilt cross-compilers for linux, but some of the other puzzle pieces haven’t quite fallen into place. If you want to dive in, drop me a line! And windows… is farther behind :(. The “compile to native” story for the reason ecosystem is in flux right now, so the particulars of how we install & configure cross-compilers will likely change in the next year or so.

The tool is called reprocessing-scripts , but the best way for you to get started is with an example game I made for this post. The amazing cross-platform graphics library we’re using is called reprocessing , made by bsansouci and schmavery .

Setup

You’ll need ocaml compilers that are capable of building to android & ios targets. Normally this would take like 45 minutes to set up, but I’ve prebuilt some compilers for you.

Clone https://github.com/jaredly/ocaml-cross-mobile into ~/.ocaml-cross-mobile , and run ./download.sh to download the appropriate cross-compilers. You’ll also need to grab the android ndk if you want to build for android, with ./get-ndk.sh .

The example project

Next, clone the example game from https://github.com/jaredly/reprocessing-example-cross-platform and put it somewhere.

Install the dependencies with npm install (I’m on npm 5.6.0, node 8.4.0). This will take a minute, but probably not more than 4 or 5.

Build & Run!

npm start will compile the app to native desktop and start it up – with hot-reloading! You’ll see a window pop up with the game, ready to try out.

If you go into src/Game.re and edit something small (like a color or position), you should see it hot reload!

If the game crashes for some reason (as can happen if you change the type of state ), the script will restart it for you.

Web target

npm run serve will compile your app to js, run pack.re on it, and serve it up with hot reloading .

Android target

npm run android:run will build the shared library, build an apk, and install it on whatever device/emulator you have connected.

OCaml currently compiles with “text relocations”, which recent android versions are unhappy about. This means that debug apks have a little popup complaining about it. Fortunately, release apks (such as you send to the play store) do not have the popup, so it still works.

:gift::gift: Bonus: :gift::gift: android hot reloading!! npm run android:hot will compile, install on your emulator/device, and proceed to hot-reload as you make changes to the code :heart_eyes:. This requires that your phone be on the same wifi network as your computer.

iOS target

npm run ios will build the app into a static library that Xcode can then use in an iOS app, targeting the simulator or a device. npm run ios:sim will build & open a simulator, and npm run ios:device will build & run on your usb-connected device.

If you’re excited about getting hot reloading going on iOS, talk to me! I’ve gone a fair way down that road but got stuck, and I’d love some help!

Native Mac Bundle

npm run bundle does an optimised compilation for native desktop, and generates a .app bundle for you.

Profit!

And that’s all you need to get your game running on 4 platforms! Now you just have to build it :smile:

For reference, here are some games that have been written with reprocessing:

As always, if you have questions (or just want to chat) come join our Discord channel or @ me on twitter .

關鍵詞:OCaml 安卓開發

相關推薦:

Building a 3D application with Electron and BabylonJS using TypeScript

Issues #32 Jan 15, 2018

Adding the Django CSRF Protection to React Forms

Demystifying DynamoDB Streams: An Introduction to Ordering, Deduplication and Checkpointing

Microsoft’s Open Source PowerShell Offers Cross-Platform Automation

Generate Cold Storage Paper Wallets For Ripple XRP Coins With Angular

Goals and Directions for Rust in 2018

Testing Vue CLI reload

Combining GraphQL and Vuex

Exploring Reason and GraphQL