Skip to content

Repository files navigation

Crossbow Splash Image

CI InfoCrate InfoDocumentationCrossbundle CrateMIT/Apache 2.0FOSSA StatusGitHub Stars

What is Crossbow?

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.

Why Crossbow?

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.

Design Goals

  • 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!

Documentation

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.

Project structure

Crossbundle crates:

NameDescriptionStatus
crossbundleCommand-line tool for building and running applications.
crossbundle-toolsToolkit used in crossbundle to build/pack/sign bundles.

Crossbow Platform crates:

NameDescriptionStatus
crossbow-androidCrossbow Android Platform implementation.🆗
crossbow-iosCrossbow iOS Platform implementation.🛠

Crossbow Plugins:

NameDescriptionStatus
admob-androidGoogle AdMob Plugin for Android.🆗
play-games-servicesGoogle Play Games Services Plugin for Android.🆗
play-billingGoogle Play Billing Plugin for Android.🆗
play-coreGoogle Play Core Plugin for Android.📝

Helper crates:

NameDescriptionStatus
android-tools-rsAndroid-related tools for building and developing application.
android-manifest-rsAndroidManifest serializer and deserializer for Rust.
apple-bundle-rsAppleBundleResources serializer and deserializer for Rust.

✅ = Works and tested — 🆗 = Works but may contain bugs — 🛠 = Under development — 📝 = Planned

Special Thanks

Also, this project initially funded by Web3 Foundation Grants Program. Big shout-out to them!

W3F Grants Badge

License

Licensed under either of:

at your option.

FOSSA Status

About

Cross-Platform build tools and toolkit for games and game engines written in Rust! 🦀

Topics

Resources

Stars

212 stars

Watchers

8 watching

Forks

Releases

Packages

Used by

Contributors

Languages