cargo-vita

Cargo command to work with Sony PlayStation Vita rust project binaries.

For general guidelines see vita-rust wiki

Requirements

• VitaSDK must be installed, and VITASDK environment variable must point to its location.
• vitacompanion for ftp and command server (uploading and running artifacts)
• PrincessLog is required for cargo vita logs
• vita-parse-core for cargo vita coredump parse

Installation

cargo +nightly install cargo-vita

Usage

Use the nightly toolchain to build Vita apps (either by using rustup override nightly for the project directory or by adding +nightly in the cargo invocation).

``` Cargo wrapper for developing Sony PlayStation Vita homebrew apps

Usage: cargo vita [OPTIONS]

Commands: build Builds the Rust binary/tests/examples into a VPK or any of the intermediate steps upload Uploads files and directories to the Vita vita ftp run Starts an installed title on the Vita by the title id logs Start a TCP server on this machine, to which Vita can stream logs via PrincessLog coredump Download coredump files from the Vita reboot Reboot the Vita help Print this message or the help of the given subcommand(s)

Options: -v, --verbose... Print the exact commands cargo-vita is running. Passing this flag multiple times will enable verbose mode for the rust compiler -h, --help Print help (see more with '--help') -V, --version Print version ```

The build command pass-through arguments are passed to cargo build.

Parameterizing your project

cargo-vita uses information in Cargo.toml to build your vpk.

Add the following section to Cargo.toml of your project:

```toml [package.metadata.vita]

A unique identifier for your project. 9 chars, alphanumeric.

title_id = "RUSTAPP01"

A title that will be shown on a bubble. Optional, will take the crate name as the default

title_name = "My application"

Optional. A path to static files relative to the project.

assets = "static"

Optional, this is the default

buildstd = "std,panicunwind"

Optional, this is the default

vitastripflags = ["-g"]

Optional, this is the default

vitamakefself_flags = ["-s"]

Optional, this is the default

vitamksfoexflags = ["-d", "ATTRIBUTE2=12"] ```

Examples

```

Build all current/all workspace projects in release mode as vpk

cargo vita -v build vpk -- --release

Build tests of current/all workspace projects in release mode as vpk

cargo vita -v build vpk -- --release --tests

Build examples of current/all workspace projects in release mode as vpk and upload vpk files to ux0:/download/

cargo vita -v build vpk --upload -- --release --examples

Build a eboot.bin, upload it to Vita and run it. The VPK must already be installed for that to work.

cargo vita -v build eboot --update --run -- --release

Start a TCP server and listen for logs. Send a termination signal to stop (e.g. ctrl+c)

cargo vita -v logs ```

License

Except where noted (below and/or in individual files), all code in this repository is dual-licensed under either:

• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option.