chore (repo): Add README.md for mesh_service_example (#2324)

Signed-off-by: James Rich <2199651+jamesarich@users.noreply.github.com>
This commit is contained in:
James Rich 2025-07-02 18:24:11 +00:00 committed by GitHub
parent 31e4ca52cc
commit eda25a0ee4
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -0,0 +1,33 @@
# mesh_service_example
This module provides an example implementation of an app that uses the [AIDL](https://developer.android.com/develop/background-work/services/aidl) Mesh Service provided by Meshtastic-Android project.
## Overview
The [AIDL](../app/src/main/aidl/com/geeksville/mesh/IMeshService.aidl) is defined in the main app module and is used to interact with the mesh network.
`mesh_service_example` demonstrates how to build and integrate a custom mesh service within the Meshtastic ecosystem. It is intended as a reference for developers who want to extend or customize mesh-related functionality.
## Features
- Example service structure for mesh integration
- Sample code for service registration and communication
## Usage
1. Clone the Meshtastic-Android repository.
2. Open the project in Android Studio.
3. Explore the `mesh_service_example` module source code under `mesh_service_example/src/`.
4. Use this module as a template for your own mesh service implementations.
## Development
- To build the module, use the standard Gradle build commands:
```sh
./gradlew :mesh_service_example:build
```
- To run tests for this module:
```sh
./gradlew :mesh_service_example:test
```
## License
This example module is provided under the same license as the main Meshtastic-Android project. See the root `LICENSE` file for details.