# Installation Guide

## Prerequisites

- Windows with WSA installed
- ADB access to WSA
- JDK 17 (for building from source)
- Python 3 (for build script)

## Build from Source

### Windows

```cmd
build.bat
```

### Linux/Mac

```bash
chmod +x build.sh
./build.sh
```

### Direct Build

```bash
python builder/build.py
```

The build script will:
1. Check for JDK 17
2. Download Android SDK if needed
3. Generate Kotlin source files
4. Build the APK using Gradle

## Install APK

### Using ADB

```bash
adb install output/app-release.apk
```

### Using WSA Installer

The WSA WebDev APK is automatically installed by WSA Installer when enabling file sharing.

## Configure

Edit `config.json` to customize server settings:

```json
{
  "port": 8088,
  "host": "127.0.0.1",
  "rootAccess": true,
  "anonymousAccess": true,
  "maxConnections": 50
}
```

## Start Server

### User Mode

```bash
adb shell am start -n com.wsa.webdav/.MainActivity
```

### Root Mode

```bash
adb shell su -c "sh /data/data/com.wsa.webdav/files/app.sh start"
```

## Access Files

- **Web File Manager:** http://127.0.0.1:8088
- **WebDAV URL:** http://127.0.0.1:8088/files/

## Mount as Windows Drive

WSA Installer can automatically mount the WebDAV share as a Windows drive. See the [WSA Installer documentation](https://github.com/WSA-Installer/wsa-installer/blob/main/docs/webdav.md) for details.