hello-world is a simple, minimal project to serve as a template for creating an app for the Embassy.
Prepare your EmbassyOS build enviroment. In this example we are using Ubuntu 20.04.
- Install docker
curl -fsSL https://get.docker.com -o- | bash
sudo usermod -aG docker "$USER"
exec sudo su -l $USER
- Set buildx as the default builder
docker buildx install
docker buildx create --use
- Enable cross-arch emulated builds in docker
docker run --privileged --rm linuxkit/binfmt:v0.8
- Install yq
sudo snap install yq
- Install essentials build packages
sudo apt-get install -y build-essential openssl libssl-dev libc6-dev clang libclang-dev ca-certificates
- Install Rust
curl https://sh.rustup.rs -sSf | sh
# Choose nr 1 (default install)
source $HOME/.cargo/env
- Install toml
cargo install toml-cli
- Build and install embassy-sdk
cd ~/ && git clone https://github.com/Start9Labs/embassy-os.git
cd embassy-os/appmgr/
cargo install --path=. --features=portable --no-default-features && cd ~/
Now you are ready to build your first EmbassyOS service
Clone the project locally. Note the submodule link to the original project(s).
git clone https://github.com/Start9Labs/hello-world-wrapper.git
cd hello-world-wrapper
To build the project, run the following commands:
make
SSH into an Embassy device.
scp the .s9pk to any directory from your local machine.
Run the following command to determine successful install:
sudo appmgr install hello-world.s9pk