# AVD - Android Virtuele Toestel {{#include ../../banners/hacktricks-training.md}} Baie dankie aan [**@offsecjay**](https://twitter.com/offsecjay) vir sy hulp tydens die skep van hierdie inhoud. ## Wat is Android Studio maak dit moontlik om **Android virtuele masjiene te draai wat jy kan gebruik om APKs te toets**. Om dit te gebruik benodig jy: - Die **Android SDK tools** - [Download here](https://developer.android.com/studio/releases/sdk-tools). - Of **Android Studio** (met Android SDK tools) - [Download here](https://developer.android.com/studio). Op Windows (in my geval) **na die installasie van Android Studio** het ek die **SDK Tools geïnstalleer in**: `C:\Users\\AppData\Local\Android\Sdk\tools` Op mac kan jy die **SDK tools** aflaai en hulle in die PATH hê deur die volgende uit te voer: ```bash brew tap homebrew/cask brew install --cask android-sdk ``` Of vanaf **Android Studio GUI** soos aangedui in [https://stackoverflow.com/questions/46402772/failed-to-install-android-sdk-java-lang-noclassdeffounderror-javax-xml-bind-a](https://stackoverflow.com/questions/46402772/failed-to-install-android-sdk-java-lang-noclassdeffounderror-javax-xml-bind-a) wat hulle in `~/Library/Android/sdk/cmdline-tools/latest/bin/` en `~/Library/Android/sdk/platform-tools/` en `~/Library/Android/sdk/emulator/` sal installeer Vir die Java-probleme: ```java export JAVA_HOME=/Applications/Android\ Studio.app/Contents/jbr/Contents/Home ``` ## GUI ### Prepare Virtual Machine As jy Android Studio geïnstalleer het, kan jy net die hoofprojek-oorsig oopmaak en toegang kry tot: _**Tools**_ --> _**AVD Manager.**_
Then, click on _**Create Virtual Device**_
_**kies** die telefoon wat jy wil gebruik_ en klik op _**Next.**_ > [!WARNING] > As jy 'n telefoon met Play Store geïnstalleer benodig, kies een met die Play Store-ikoon daarop! > > In die huidige aansig kan jy **kies en aflaai die Android image** wat die telefoon gaan gebruik:
So, select it and if it isn't downloaded click on the _**Download**_ symbol next to the name (**now wait until the image is downloaded).**\ Once the image is downloaded, just select **`Next`** and **`Finish`**. Die virtuele masjien sal geskep word. Nou sal dit **elke keer as jy die AVD Manager oopmaak, beskikbaar wees**. ### Run Virtual Machine Om dit te begin, druk net die _**Start button**_. ![](<../../images/image (518).png>) ## Command Line tool > [!WARNING] > Vir macOS kan jy die `avdmanager` tool vind in `/Users//Library/Android/sdk/tools/bin/avdmanager` en die `emulator` in `/Users//Library/Android/sdk/emulator/emulator` as jy dit geïnstalleer het. Eerstens moet jy **besluit watter telefoon jy wil gebruik**, om die lys van moontlike telefone te sien voer uit: ``` C:\Users\\AppData\Local\Android\Sdk\tools\bin\avdmanager.bat list device d: 0 or "automotive_1024p_landscape" Name: Automotive (1024p landscape) OEM : Google Tag : android-automotive-playstore --------- id: 1 or "Galaxy Nexus" Name: Galaxy Nexus OEM : Google --------- id: 2 or "desktop_large" Name: Large Desktop OEM : Google Tag : android-desktop --------- id: 3 or "desktop_medium" Name: Medium Desktop OEM : Google Tag : android-desktop --------- id: 4 or "Nexus 10" Name: Nexus 10 OEM : Google [...] ``` Sodra jy die naam van die toestel wat jy wil gebruik bepaal het, moet jy **bepaal watter Android image jy op hierdie toestel wil laat loop.**\ Jy kan al die opsies lys met `sdkmanager`: ```bash C:\Users\\AppData\Local\Android\Sdk\tools\bin\sdkmanager.bat --list ``` En **laai af** die een (of almal) wat jy wil gebruik met: ```bash C:\Users\\AppData\Local\Android\Sdk\tools\bin\sdkmanager.bat "platforms;android-28" "system-images;android-28;google_apis;x86_64" ``` Sodra jy die Android-beeld wat jy wil gebruik afgelaai het, kan jy **al die afgelaaide Android-beelde lys** met: ``` C:\Users\\AppData\Local\Android\Sdk\tools\bin\avdmanager.bat list target ---------- id: 1 or "android-28" Name: Android API 28 Type: Platform API level: 28 Revision: 6 ---------- id: 2 or "android-29" Name: Android API 29 Type: Platform API level: 29 Revision: 4 ``` Op hierdie stadium het jy besluit watter toestel jy wil gebruik en jy het die Android image afgelaai, dus **kan jy die virtuele masjien skep met behulp van**: ```bash C:\Users\\AppData\Local\Android\Sdk\tools\bin\avdmanager.bat -v create avd -k "system-images;android-28;google_apis;x86_64" -n "AVD9" -d "Nexus 5X" ``` In die laaste opdrag **het ek 'n VM geskep genaamd** "_AVD9_" deur die **toestel** "_Nexus 5X_" en die **Android-image** "_system-images;android-28;google_apis;x86_64_" te gebruik.\ Nou kan jy **lys die virtuele masjiene** wat jy geskep het met: ```bash C:\Users\\AppData\Local\Android\Sdk\tools\bin\avdmanager.bat list avd Name: AVD9 Device: Nexus 5X (Google) Path: C:\Users\cpolo\.android\avd\AVD9.avd Target: Google APIs (Google Inc.) Based on: Android API 28 Tag/ABI: google_apis/x86_64 The following Android Virtual Devices could not be loaded: Name: Pixel_2_API_27 Path: C:\Users\cpolo\.android\avd\Pixel_2_API_27_1.avd Error: Google pixel_2 no longer exists as a device ``` ### Voer Virtuele Masjien uit > [!WARNING] > Vir macOS kan jy die `avdmanager` tool in `/Users//Library/Android/sdk/tools/bin/avdmanager` en die `emulator` in `/Users//Library/Android/sdk/emulator/emulator` vind as jy hulle geïnstalleer het. Ons het reeds gesien hoe jy die gemaakte virtuele masjiene kan lys, maar **jy kan hulle ook lys met behulp van**: ```bash C:\Users\\AppData\Local\Android\Sdk\tools\emulator.exe -list-avds AVD9 Pixel_2_API_27 ``` Jy kan eenvoudig **enige geskepte virtuele masjien uitvoer** met: ```bash C:\Users\\AppData\Local\Android\Sdk\tools\emulator.exe -avd "VirtualMachineName" C:\Users\\AppData\Local\Android\Sdk\tools\emulator.exe -avd "AVD9" ``` Of deur meer gevorderde opsies te gebruik, kan jy 'n virtuele masjien soos die volgende laat loop: ```bash C:\Users\\AppData\Local\Android\Sdk\tools\emulator.exe -avd "AVD9" -http-proxy 192.168.1.12:8080 -writable-system ``` ### Command line options Daar is egter **a lot of different command line useful options** wat jy kan gebruik om 'n virtuele masjien te begin. Hieronder kan jy 'n paar interessante opsies vind maar kan [**find a complete list here**](https://developer.android.com/studio/run/emulator-commandline) **Opstart** - `-snapshot name` : Start VM snapshot - `-snapshot-list -snapstorage ~/.android/avd/Nexus_5X_API_23.avd/snapshots-test.img` : Lys alle geregistreerde snapshots **Netwerk** - `-dns-server 192.0.2.0, 192.0.2.255` : Laat toe om die DNS-bedieners as 'n komma-geskeide lys aan die VM aan te dui. - **`-http-proxy 192.168.1.12:8080`** : Laat toe om 'n HTTP-proxy aan te dui om te gebruik (baie nuttig om verkeer met Burp vas te vang) - If the proxy settings aren't working for some reason, try to configure them internally or using an pplication like "Super Proxy" or "ProxyDroid". - `-netdelay 200` : Stel die netwerklatensie-emulasie in millisekondes. - `-port 5556` : Stel die TCP-poortnommer wat vir die konsole en adb gebruik word. - `-ports 5556,5559` : Stel die TCP-poorte wat vir die konsole en adb gebruik word. - **`-tcpdump /path/dumpfile.cap`** : Neem al die verkeer in 'n lêer op **Stelsel** - `-selinux {disabled|permissive}` : Stel die Security-Enhanced Linux sekuriteitsmodule op 'n Linux-bedryfstelsel. - `-timezone Europe/Paris` : Stel die tydsone vir die virtuele toestel - `-screen {touch(default)|multi-touch|o-touch}` : Stel die geëmuleerde raakskermmodus in. - **`-writable-system`** : Gebruik hierdie opsie om 'n skryfbare stelselbeeld tydens jou emulasiesessie te hê. Jy sal ook moet `adb root; adb remount`. Dit is baie nuttig om 'n nuwe sertifikaat in die stelsel te installeer. ## Linux CLI setup (SDK/AVD quickstart) Die amptelike CLI-instrumente maak dit maklik om vinnige, ontfoutbare emulators te skep sonder Android Studio. ```bash # Directory layout mkdir -p ~/Android/cmdline-tools/latest # Download commandline tools (Linux) wget https://dl.google.com/android/repository/commandlinetools-linux-13114758_latest.zip -O /tmp/cmdline-tools.zip unzip /tmp/cmdline-tools.zip -d ~/Android/cmdline-tools/latest rm /tmp/cmdline-tools.zip # Env vars (add to ~/.bashrc or ~/.zshrc) export ANDROID_HOME=$HOME/Android export PATH=$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$PATH # Install core SDK components sdkmanager --install "platform-tools" "emulator" # Install a debuggable x86_64 system image (Android 11 / API 30) sdkmanager --install "system-images;android-30;google_apis;x86_64" # Create an AVD and run it with a writable /system & snapshot name avdmanager create avd -n PixelRootX86 -k "system-images;android-30;google_apis;x86_64" -d "pixel" emulator -avd PixelRootX86 -writable-system -snapshot PixelRootX86_snap # Verify root (debuggable images allow `adb root`) adb root adb shell whoami # expect: root ``` Aantekeninge - Stelselbeeld-variante: google_apis (debuggable, laat `adb root` toe), google_apis_playstore (nie-rootbaar nie), aosp/default (liggewig). - Bouwtipes: userdebug laat dikwels `adb root` toe op debug-ondersteunende images. Play Store images is produksie-boues en blokkeer root. - Op x86_64-gashere is volstelsels ARM64-emulasie nie ondersteun vanaf API 28+ nie. Vir Android 11+ gebruik Google APIs/Play images wat per-app ARM-na-x86-vertaling insluit om baie ARM-only apps vinnig te laat loop. ### Snapshots vanaf die CLI ```bash # Save a clean snapshot from the running emulator adb -s emulator-5554 emu avd snapshot save my_clean_setup # Boot from a named snapshot (if it exists) emulator -avd PixelRootX86 -writable-system -snapshot my_clean_setup ``` ## ARM→x86 binary translation (Android 11+) Google APIs en Play Store-images op Android 11+ kan ARM-app-binaire per proses vertaal terwyl die res van die stelsel native x86/x86_64 bly. Dit is dikwels vinnig genoeg om baie slegs-ARM-apps op 'n lessenaar te toets. > Tip: Verkies Google APIs x86/x86_64-images tydens pentests. Play-images is gerieflik maar blokkeer `adb root`; gebruik hulle slegs wanneer jy spesifiek Play services benodig en die gebrek aan root aanvaar. ## Rooting a Play Store device If you downloaded a device with Play Store you are not going to be able to get root directly, and you will get this error message ``` $ adb root adbd cannot run as root in production builds ``` Deur [rootAVD](https://github.com/newbit1/rootAVD) met [Magisk](https://github.com/topjohnwu/Magisk) te gebruik, kon ek dit root (volg byvoorbeeld [**this video**](https://www.youtube.com/watch?v=Wk0ixxmkzAI) of [**this one**](https://www.youtube.com/watch?v=qQicUW0svB8)). ## Installeer Burp Sertifikaat Kyk na die volgende bladsy om te leer hoe om 'n pasgemaakte CA cert te installeer: {{#ref}} install-burp-certificate.md {{#endref}} ## Nuttige AVD-opties ### Neem 'n Snapshot Jy kan **die GUI gebruik** om te eniger tyd 'n snapshot van die VM te neem: ![](<../../images/image (234).png>) ## References - [Build a Repeatable Android Bug Bounty Lab: Emulator vs Magisk, Burp, Frida, and Medusa](https://www.yeswehack.com/learn-bug-bounty/android-lab-mobile-hacking-tools) - [Android Emulator command line](https://developer.android.com/studio/run/emulator-commandline) - [Run ARM apps on the Android Emulator (x86 translation)](https://android-developers.googleblog.com/2020/03/run-arm-apps-on-android-emulator.html) {{#include ../../banners/hacktricks-training.md}}