#build-system #garmin #alpha #aware #package #resources #connect-iq

build kumitateru

Build system for Garmin ConnectIQ. Simple, fast, powerful!

1 unstable release

0.4.0 Nov 14, 2021

#554 in Build Utils

GPL-3.0-or-later

57KB
1K SLoC

Kumitateru

Kumitateru is a build system for Garmin ConnectIQ, written in Rust.

It is ALPHA software, be aware

Project structure

The basic directory structure looks like this:

├── id_rsa_garmin.der
├── kumitateru
├── package.toml
├── resources
│   ├── drawables
│   │   ├── drawables.xml
│   │   └── launcher_icon.png
│   ├── fonts
│   │   └── fenix5
│   ├── layouts
│   ├── menus
│   ├── settings
│   └── strings
│       └── main
│           └── strings.xml
└── src

Build config

Build config sits in the root of the project, and named package.toml. It looks like this:

[package]
name_res = "@Strings.AppName"
icon_resource = "@Drawables.LauncherIcon"
main_class = "MyApp"
# Currently here for the future, exactly for supporting libraries(barrels) as projects, not only apps.
package_type = "app"
app_type = "watch-app"
min_sdk = "1.2.0"
# This property is for setting the SDK, which will be used to build the app
target_sdk = "4.0.4"

[package_meta]
name = "MyApp"
id = "app-id"
version = "1.0.0"
devices = ["fenix6xpro"]
permissions = ["Background"]
languages = ["eng"]

[build]
signing_key = "id_garmin_sign.der"
# This will be, again, for future. Will be used for code analysis, like possible places of crash, bad design, and much more
code_analysis_on_build = false
type_check_level = 0 # Type checking, which was introduced in CIQ 4.0.0. Levels: 0: disable, 1: gradual, 2: informative, 3: strict
compiler_args = "" # If you want some custom parameters, place them here

[dependencies]
"simple-barrel" = ["0.1.0", "simple-barrel-0.1.0.barrel"] # The second entry is a path to the barrel inside of dependencies folder.

For now Kumitateru does not support external dependencies(or barrels, as Garmin calls them), but I will figure out later how to add them, specifically when i will learn the full structure of Connect IQ manifest and monkey.jungle.

Using the build system

Basic build command is ./kumitateru build, which compiles the app in .iq format. To build for a specific device, run ./kumitateru build --target <device>. To build for all devices in .prg, you run ./kumitateru build --target all.

Dependencies

~7–16MB
~206K SLoC