# cargo-app
cargo subcommand to pack a binary to a MacOS .app bundle

### install
Recommended to install with `cargo install`:
```sh
cargo install cargo-app
```
to update to the latest version:
```sh
cargo install cargo-app --force
```

### usage
```sh
USAGE:
    cargo-app [SUBCOMMAND]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

SUBCOMMANDS:
    help    Prints this message or the help of the given subcommand(s)
    pack    Generate .app bundle according to configs in Cargo.toml
```

### example
generate .app bundle according to configs in Cargo.toml
```sh
cargo app
```

## config
```toml
[package.metadata.app]
# path to the bundle, defaults to {{package_name}}.app
out         = "yo.app"
# path to the binary file, defaults to "target/x86_64-apple-darwin/release/{{package_name}}"
bin          = "yo"
# name of the bundle
name         = "yo"
# display name of the bundle
display_name = "YO"
# bundle identifier
identifier   = "com.company.yo"
# path of the bundle icon file
icon         = "icon.icns"
# bundle version
version      = "0.0.0"
# paths to copy to the Resources folder
resources    = []
# paths to copy to the Frameworks folder
frameworks   = []
```