CrossBundle CLI

The crossbundle is a command-line tool that encapsulates boring stuff of Android and iOS build/packaging processes and helps mobile developers to create and maintain applications written in rust programming language.

Installation:

sh cargo install --git=https://github.com/dodorare/crossbow crossbundle

NOTE

For the correct work of the tool, you need to set up a development environment (ex. install some libraries and tools - such as Android SDK, Android NDK, XCode, etc). More information about how to set up the environment in the Android setup and iOS setup wiki pages.

Syntax

To see the complete documentation for each command/subcommand you can write -h or --help: crossbundle -h crossbundle build android -h crossbundle run android -h

Command crossbundle

sh crossbundle <SUBCOMMAND> [FLAGS] [OPTIONS]

SUBCOMMANDS:
    build    Starts the process of building/packaging/signing of the rust crate
    help     Prints this message or the help of the given subcommand(s)
    log      Attach logger to device with running application
    new      Creates a new Cargo package in the given directory. Project will be ready to build
             with `crossbundle`
    run      Executes `build` command and then deploy and launches the application on the
             device/emulator

FLAGS:
    -h, --help       Prints help information
    -q, --quiet      No output printed to stdout
    -v, --verbose    A level of verbosity, and can be used multiple times
    -V, --version    Prints version information

OPTIONS:
    -c, --current-dir     The current directory where to run all commands

Command crossbundle build android

sh crossbundle build android [FLAGS] [OPTIONS]

FLAGS:
        --all-features           Activate all available features of selected package
    -h, --help                   Prints help information
        --no-default-features    Do not activate the `default` feature of the current directory's
                                 package
        --release                Build optimized artifact with the `release` profile
    -V, --version                Prints version information
    --quad                   Runs the subcommand for a `macroquad` project

OPTIONS:
        --example                Build the specified example

        --features ...           Space or comma separated list of features to activate. These
                                 features only apply to the current directory's package.
                                 Features of direct dependencies may be enabled with `dep-
                                 name/feature-name` syntax. This flag may be specified
                                 multiple times, which enables all specified features

        --target ...             Build for the given android architecture. Supported targets
                                 are: `armv7-linux-androideabi`, `aarch64-linux-android`, `i686-
                                 linux-android`, `x86_64-linux-android` [default: aarch64-linux-
                                 android]

        --target-dir             Directory for generated artifact and intermediate files

Command crossbundle build apple

sh crossbundle build apple [FLAGS] [OPTIONS]

FLAGS:
        --all-features           Activate all available features of selected package
    -h, --help                   Prints help information
        --no-default-features    Do not activate the `default` feature of the current directory's
                                 package
        --release                Build optimized artifact with the `release` profile
    -V, --version                Prints version information

OPTIONS:
        --bin                    Specify custom cargo binary
        --example                Build the specified example

        --features ...           Space or comma separated list of features to activate. These features only apply to the
                                 current directory's package. Features of direct dependencies may be enabled with `dep-
                                 name/feature-name` syntax. This flag may be specified multiple times, which enables
                                 all specified features

        --identity               The id of the identity used for signing. It won't start the signing process until you
                                 provide this flag

        --profile-name           Provisioning profile name to find in this directory:
                                 `~/Library/MobileDevice/Provisioning\ Profiles/`

        --profile-path           Absolute path to provisioning profile

        --target ...             Build for the given apple architecture. Supported targets are: 'aarch64-apple-ios`,
                                 `armv7-apple-ios`, `armv7s-apple-ios`, `i386-apple-ios`, `x86_64-apple-ios` [default:
                                 aarch64-apple-ios]

        --target-dir             Directory for generated artifact and intermediate files

        --team-identifier        The team identifier of your signing identity