mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-03-27 10:11:48 -04:00
68 lines
2.5 KiB
Markdown
68 lines
2.5 KiB
Markdown
# `:core:api` (Meshtastic Android API)
|
|
|
|
## Overview
|
|
The `:core:api` module contains the stable AIDL interface and dependencies required for third-party applications to integrate with the Meshtastic Android app.
|
|
|
|
## Integration
|
|
|
|
To communicate with the Meshtastic Android service from your own application, we recommend using **JitPack**.
|
|
|
|
### Dependencies
|
|
Add the following to your `build.gradle.kts`:
|
|
|
|
```kotlin
|
|
dependencies {
|
|
// The core AIDL interface and Intent constants
|
|
implementation("com.github.meshtastic.Meshtastic-Android:meshtastic-android-api:v2.x.x")
|
|
|
|
// Data models (DataPacket, MeshUser, NodeInfo, etc.) - Kotlin Multiplatform
|
|
implementation("com.github.meshtastic.Meshtastic-Android:meshtastic-android-model:v2.x.x")
|
|
|
|
// Protobuf definitions (PortNum, Telemetry, etc.) - Kotlin Multiplatform
|
|
implementation("com.github.meshtastic.Meshtastic-Android:meshtastic-android-proto:v2.x.x")
|
|
}
|
|
```
|
|
*(Replace `v2.x.x` with the latest stable version).*
|
|
|
|
## Usage
|
|
|
|
### 1. Bind to the Service
|
|
Use the `IMeshService` interface to bind to the Meshtastic service.
|
|
|
|
```kotlin
|
|
val intent = Intent("com.geeksville.mesh.Service")
|
|
// ... query package manager and bind
|
|
```
|
|
|
|
### 2. Interact with the API
|
|
Once bound, cast the `IBinder` to `IMeshService`.
|
|
|
|
### 3. Register a BroadcastReceiver
|
|
Use `MeshtasticIntent` constants for actions. Remember to use `RECEIVER_EXPORTED` on Android 13+.
|
|
|
|
## Key Components
|
|
- **`IMeshService.aidl`**: The primary AIDL interface.
|
|
- **`MeshtasticIntent.kt`**: Defines Intent actions for received messages and status changes.
|
|
|
|
## Module dependency graph
|
|
|
|
<!--region graph-->
|
|
```mermaid
|
|
graph TB
|
|
:core:api[api]:::android-library
|
|
:core:api --> :core:model
|
|
|
|
classDef android-application fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef android-application-compose fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef compose-desktop-application fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef android-feature fill:#FFD6A5,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef android-library fill:#9BF6FF,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef android-library-compose fill:#9BF6FF,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef android-test fill:#A0C4FF,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef jvm-library fill:#BDB2FF,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef kmp-library fill:#FFC1CC,stroke:#000,stroke-width:2px,color:#000;
|
|
classDef unknown fill:#FFADAD,stroke:#000,stroke-width:2px,color:#000;
|
|
|
|
```
|
|
<!--endregion-->
|