wifiattack/docs/DEVELOPMENT.md

Development Setup Guide

Prerequisites

Java Version

This project requires Java 17-21 for building. Java 25+ is not yet supported by Gradle 8.7.

If you have multiple Java versions installed, set JAVA_HOME before building:

export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
./gradlew assembleDebug

Android SDK

• Minimum SDK: 24 (Android 7.0)
• Target SDK: 35 (Android 15)
• Compile SDK: 35

Required SDK Components

• Android SDK Platform 35
• Android SDK Build-Tools
• Android Emulator (optional, for testing)

Building the Project

Debug Build

./gradlew assembleDebug

The APK will be located at: app/build/outputs/apk/debug/app-debug.apk

Release Build

./gradlew assembleRelease

Note: Release builds require signing configuration.

Running Tests

Unit Tests

./gradlew test

Instrumented Tests

./gradlew connectedAndroidTest

IDE Setup

Android Studio

1. Open Android Studio
2. Select "Open an existing project"
3. Navigate to the project directory
4. Wait for Gradle sync to complete

IntelliJ IDEA

1. Open IntelliJ IDEA
2. Select "Import Project"
3. Choose the build.gradle.kts file
4. Select "Open as Project"

Troubleshooting

Build Fails with Java Version Error

If you see an error related to Java version (e.g., "25.0.1"):

1. Check your Java version: java --version
2. If using Java 25+, switch to Java 21
3. Set JAVA_HOME to point to Java 21

Gradle Sync Issues

1. Clear Gradle caches: ./gradlew clean
2. Invalidate caches in Android Studio: File > Invalidate Caches
3. Re-sync the project

Missing SDK Components

Install required components through:

• Android Studio SDK Manager
• Or command line: sdkmanager "platforms;android-35"