kmp-build-commands

Files (1)

• SKILL.md

SKILL.md (first lines)

# KMP Build Commands

> The kmptv project uses Gradle with the Android Gradle Plugin. All builds run from the project root. The Android TV app produces an APK; the Apple TV app builds via Xcode.

## Android TV builds

### Debug APK (development)

```bash
./gradlew :androidtv-app:assembleDebug
```

**Output:** `androidtv-app/build/outputs/apk/debug/androidtv-app-debug.apk`

- Debuggable, not minified
- Fast build (~30-60s after first build)
- Use for emulator testing and development

### Release APK (production)

```bash
./gradlew :androidtv-app:assembleRelease
```

**Output:** `androidtv-app/build/outputs/apk/release/androidtv-app-release-unsigned.apk`

- Minified (if proguard is enabled, currently disabled in template)
- Not debuggable
- Requires signing for device installation

### Build both variants

```bash
./gradlew :androidtv-app:assemble
```

## Installing on emulator

### Prerequisites

- Android TV emulator running (API 34, TV profile recommended)
- Android CLI installed and initialized with `android init`
- `adb` in PATH for D-pad input and Logcat only

### Build, install, and launch the debug APK

```bash
# Android CLI describes targets and expected output artifacts.
android describe --project_dir=.

# Gradle owns compilation.
./gradlew :androidtv-app:assembleDebug

# Android CLI owns deployment and launch.
android run \
  --apks=androidtv-app/build/outputs/apk/debug/androidtv-app-debug.apk \
  --device=<serial> \
  --activity=.MainActivity
```

## Shared-core builds

### Compile for Android target

```bash
./gradlew :shared-core:compileKotlinAndroid
```

### Compile for iOS targets (requires macOS)

```bash
./gradlew :shared-core:compileKotlinIosArm64
./gradlew :shared-core:compileKotlinIosSimulatorArm64
./gradlew :shared-core:compileKotlinIosX64
```

### Run all shared-core tests

```bash
./gradlew :shared-core:allTests
```

### Generate iOS framework (for Apple TV app)

```bash
./gradlew :shared-core:linkDebugFrameworkIosSimulatorArm64
```

**Output:** `shared-core/build/bin/iosSimulatorArm64/debugFramework/shared_core.framework`

## Full project builds

### Compile everything

```bash
./gradlew compileKotlin
```

### Clean build (when caches are stale)

```bash
./gradlew clean :androidtv-app:assembleDebug
```

### Check dependencies

```bash
# Show dependency tree for androidtv-app
./gradlew :androidtv-app:dependencies --configuration releaseRuntimeClasspath

# Check for dependency updates (if plugin installed)
./gradlew dependencyUpdates
```

## Apple TV builds (Xcode)

The Apple TV app is built via Xcode, not Gradle:

```bash

From giolaq/tv-build-harness, MIT-0.

More from giolaq/tv-build-harness