The crossbow project aims to provide a complete toolkit for cross-platform game development in Rust - from project creation to publishing. In addition, the project simplifies the creation, packaging, and signing of Android and iOS applications. We want to make most of our tools - engine agnostic to help rust game developers integrate them into their engines or games.
There are already cargo-apk, cargo-mobile, cargo-xcode, etc. - why do I need another packaging tool?
Crossbow is more than an Android and iOS packager: it is a cross-platform Rust game-development toolkit. crossbundle turns standard Cargo projects into native .apk/.aab and .app/.ipa artifacts, with optional Gradle packaging for Android plugins. crossbundle-tools provides the same building blocks for custom workflows, while crossbow-android supports Android plugins written in Java/Kotlin.
A lot of functionality was inspired by Godot, Xamarin, and cargo-apk.
- Customizable: Create new commands with available tools.
- Simple: Easy to install and start hacking but also pretty flexible for strong devs.
- Cargo-first: Builds use Cargo's public CLI and consume the artifacts Cargo reports.
- Flexible: Build native .apk/.aab and .app/.ipa artifacts, with optional Gradle packaging on Android.
- Rust: Don't leave your Rust code - everything can be configured from
Cargo.toml. - Plugins: Godot-like plugins for Android (and iOS in future) with Rust wrapper!
Now we would recommend you to read crossbow's documentation. Over there you will find how to set up development environment, install needed crates and how to use the tools.
Crossbundle crates:
| Name | Description | Status |
|---|---|---|
| crossbundle | Command-line tool for building and running applications. | β |
| crossbundle-tools | Toolkit used in crossbundle to build/pack/sign bundles. |
β |
Crossbow Platform crates:
| Name | Description | Status |
|---|---|---|
| crossbow-android | Crossbow Android Platform implementation. | π |
| crossbow-ios | Crossbow iOS Platform implementation. | π |
Crossbow Plugins:
| Name | Description | Status |
|---|---|---|
| admob-android | Google AdMob Plugin for Android. | π |
| play-games-services | Google Play Games Services Plugin for Android. | π |
| play-billing | Google Play Billing Plugin for Android. | π |
| play-core | Google Play Core Plugin for Android. | π |
Helper crates:
| Name | Description | Status |
|---|---|---|
| android-tools-rs | Android-related tools for building and developing application. | β |
| android-manifest-rs | AndroidManifest serializer and deserializer for Rust. | β |
| apple-bundle-rs | AppleBundleResources serializer and deserializer for Rust. | β |
β = Works and tested β π = Works but may contain bugs β π = Under development β π = Planned
Also, this project initially funded by Web3 Foundation Grants Program. Big shout-out to them!
Licensed under either of:
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
