# Overview

The VEE Wear Facer application provides a Watchface which can render Facer watchfaces.

# Usage

## Run on Simulator

In Android Studio or IntelliJ:

- Open the Gradle tool window by clicking on the elephant icon on the right side,
- Expand the `wear-facer-app` item,
- From the nested `Tasks` list, expand the `microej` item,
- Double-click on `runOnSimulator`,
- The Simulator starts, the traces are visible in the Run view.

To open the Facer watchface:

- Long press on the current watchface to open the watchface picker,
- Swipe to browse the installed watchfaces,
- Tap the Facer watchface thumbnail to open the watchface.

## Build the Feature

To build the Feature for the default Kernel (Actions ATS3085S):

- Open the Gradle tool window by clicking on the elephant icon on the right side,
- Expand the `wear-facer-app` item,
- From the nested `Tasks` list, expand the `microej` item,
- Double-click on `buildFeature`,
- At the end of the build, the Feature file (`application.fo`) can be found in the `build` directory
  in `build/application`.

## Using a Custom Kernel

To specify a Kernel different from the default one (Actions ATS3085S), use the following commands:

to run on Simulator
`.\gradlew runOnSimulator -P"kernelVariant"="com.microej.app.wear.<device>:wear-kernel:1.1.0"`

to build the Feature
`.\gradlew buildFeature -P"kernelVariant"="com.microej.app.wear.<device>:wear-kernel:1.1.0"`

## Using local Kernel/Vee Port projects

When the sources for the Kernel and/or VEE Port are available locally, it can be more efficient to load these projects
directly instead of resolving them as module dependencies.
This approach improves development workflow by automatically incorporating any changes made to the Kernel or VEE Port
during the application build, eliminating the need for manual dependency updates.
To achieve this, use Gradle's Composite Build feature to include the local projects, as shown in the example below:

`.\gradlew runOnSimulator -P"kernelVariant"="com.microej.app.wear.<device>:wear-kernel:1.1.0" --include-build path/to/kernel`

or

`.\gradlew runOnSimulator -P"kernelVariant"="com.microej.app.wear.<device>:wear-kernel:1.1.0" --include-build path/to/kernel --include-build path/to/veeport`

It is also possible to make the above arrangement by using ``includeBuild()`` to declare the included build in
the `settings.gradle.kts` file. For example: `includeBuild("path/to/kernel")`

For example:

```
includeBuild("path/to/kernel")
```

# Requirements

* MICROEJ SDK 6.
* A VEE Wear Kernel 1.1.0 or higher.

# Dependencies

_All dependencies are retrieved transitively by Gradle_.

# Source

N/A.

# Restrictions

None.

---
_Copyright 2024-2025 MicroEJ Corp. All rights reserved._  
_MicroEJ Corp. PROPRIETARY/CONFIDENTIAL. Use is subject to license terms._