doc.rustdesk.com/content/dev/build/android/_index.de.md

219 lines
9.0 KiB
Markdown
Raw Normal View History

2022-05-12 15:06:38 +02:00
---
title: Android
weight: 22
---
2023-01-14 23:01:18 +01:00
{{% notice note %}}
2023-03-08 22:41:52 +01:00
Diese Anleitung setzt voraus, dass Sie mit [Android NDK](https://developer.android.com/ndk/downloads), [Rust](https://rustup.rs/) und [Flutter](https://flutter.dev/) **vertraut** sind.
Wenn nicht, überspringen Sie bitte diese Seite oder lesen auf eigene Gefahr weiter.
2023-01-14 23:01:18 +01:00
{{% /notice %}}
2023-03-08 22:41:52 +01:00
{{% notice note %}}
Es ist möglich, RustDesk Android auf **Windows** und **macOS** zu bauen, aber diese Anleitung ist noch in der aktiven Entwicklung.
{{% /notice %}}
# Einführung
Hier erfahren Sie, wie Sie Ihre Umgebung so weit vorbereiten, dass Sie die App erfolgreich erstellen können und in der Lage sind, den Code z. B. mit Android Studio zu bearbeiten.
Diese Anleitung basiert auf der letzten funktionierenden Workflow-Datei, um sicherzustellen, dass alles funktioniert. Wenn Sie irgendwelche Probleme haben, kontaktieren Sie uns auf unserem [Discord](https://discord.com/invite/nDceKgxnkV) oder über einen anderen Kommunikationskanal.
Man kann die Android-Version unter Windows erstellen, ausführen und bearbeiten, benötigt aber ein Verzeichnis mit gepatchtem `Flutter`.
Mit "gepatcht" ist der Zustand des Verzeichnisses vor dem Ausführen von `flutter build` auf dem Linux-Rechner gemeint.
# Voraussetzungen
- Sie verwenden **Ubuntu 20.04** oder höher (diese Anleitung basiert auf dieser Version)
- Sie haben eine funktionierende Internetverbindung
- Sie haben bereits [**Flutter**](https://docs.flutter.dev/get-started/install/linux), [**vcpkg**](https://github.com/microsoft/vcpkg) und [**Rust**](https://www.rust-lang.org/tools/install) installiert
- Sie haben das [RustDesk-Repository](https://github.com/rustdesk/rustdesk) geklont
- Sie wissen, was Sie tun
# System
Dieser Teil der Anleitung basiert auf einer sauberen Instanz von **Ubuntu 20.04** mit bereits installierten und konfigurierten Komponenten wie **Flutter**, **Rust** und **vcpkg**.
Wenn Ihnen eine dieser Komponenten fehlt, beschaffen und konfigurieren Sie sie und kehren Sie dann hierher zurück.
# Anleitung
Dies ist eine Schritt-für-Schritt-Anleitung.
## Bridge generieren 🌉
Da dieses Projekt auf [flutter_rust_bridge](https://cjycode.com/flutter_rust_bridge/index.html) basiert, sollten Sie es zuerst generieren, was Sie mit den folgenden Befehlen erreichen können.
Wechseln Sie in das Verzeichnis `rustdesk`:
```
cd rustdesk
2023-01-14 23:01:18 +01:00
```
2023-03-08 22:41:52 +01:00
**Wenn Sie noch kein Repository haben**, klonen Sie das [RustDesk-Repository](https://github.com/rustdesk/rustdesk) mit dem folgenden Kommando:
2023-01-14 23:01:18 +01:00
2023-03-08 22:41:52 +01:00
```
2023-01-14 23:01:18 +01:00
git clone https://github.com/rustdesk/rustdesk
2023-03-08 22:41:52 +01:00
```
Dann können Sie in das Verzeichnis `rustdesk` wechseln:
```
2023-01-14 23:01:18 +01:00
cd rustdesk
2023-03-08 22:41:52 +01:00
```
Möglicherweise müssen Sie auch einige Komponenten installieren, wenn Sie dies zum ersten Mal tun:
```
2023-04-25 22:05:16 +02:00
sudo apt install ca-certificates -y
2023-03-08 22:41:52 +01:00
sudo apt update -y
sudo apt install -y g++ gcc git curl wget nasm yasm libgtk-3-dev clang cmake libclang-dev ninja-build llvm-dev libclang-10-dev llvm-10-dev pkg-config
```
### Abhängigkeiten der Flutter-Rust-Bridge installieren
In diesem Schritt werden Sie zusätzliche Abhängigkeiten installieren, die von [flutter-rust-bridge](https://cjycode.com/flutter_rust_bridge/index.html) benötigt werden. Außerdem werden Sie die Flutter-Abhängigkeiten aus der Datei `pubspec.yaml` herunterladen.
Dies kann je nach Geschwindigkeit Ihrer Internetverbindung und der Gesamtleistung Ihres Desktops einige Zeit dauern:
```
cargo install flutter_rust_bridge_codegen
pushd flutter && flutter pub get && popd
```
### Bridge-Dateien generieren
Damit alles funktioniert, müssen Sie die Flutter-Rust-Bridge generieren und einfach ausführen:
```
~/.cargo/bin/flutter_rust_bridge_codegen --rust-input ./src/flutter_ffi.rs --dart-output ./flutter/lib/generated_bridge.dart
```
Wenn alles geklappt hat, sollten Sie in Ihrem Terminal-Fenster etwas wie das hier sehen:
```yaml
2023/02/27 20:44:39 [INFO] Success!
2023/02/27 20:44:39 [INFO] Now go and use it :)
```
## RustDesk für Android erstellen 📱
### Abhängigkeiten installieren
In diesem Schritt benötigen Sie möglicherweise einige zusätzliche Abhängigkeiten, die Sie mit diesem Befehl installieren können:
```
sudo apt update -y
sudo apt-get -qq install -y git curl wget nasm yasm libgtk-3-dev clang libxcb-randr0-dev libxdo-dev libxfixes-dev libxcb-shape0-dev libxcb-xfixes0-dev libasound2-dev libpulse-dev cmake libclang-dev ninja-build libappindicator3-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libvdpau-dev libva-dev libclang-dev llvm-dev libclang-10-dev llvm-10-dev pkg-config tree g++ libc6-dev gcc-multilib g++-multilib openjdk-11-jdk-headless
```
Möglicherweise müssen Sie auch `ffigen` aktivieren:
```
dart pub global activate ffigen 5.0.1
```
### Zusätzliche Abhängigkeiten herunterladen
Für diese Anleitung haben wir einige Abhängigkeiten für Sie vorbereitet, Sie können sie gerne verwenden. Es erfordert, dass `vcpkg` installiert ist, in diesem Fall unter `/opt`:
2023-01-14 23:01:18 +01:00
2023-03-08 22:41:52 +01:00
```
pushd /opt
sudo wget https://github.com/rustdesk/doc.rustdesk.com/releases/download/console/dep.tar.gz
sudo tar xzf dep.tar.gz
popd
```
#### Warnung
Das Verzeichnis `vcpkg` muss sich unter `$HOME` befinden, wenn der Teil `RustDesk-Bibliothek bauen` dieser Anleitung Fehler auslöst wie:
```yaml
error: failed to run custom build command for `magnum-opus v0.4.0 (https://github.com/rustdesk/magnum-opus#79be072c)`
Caused by:
process didn't exit successfully: `/home/user/rustdesk/target/release/build/magnum-opus-05dc0023b86da8fc/build-script-build` (exit status: 101)
--- stdout
cargo:info=arm64-android
cargo:rustc-link-lib=static=opus
cargo:rustc-link-search=/home/user/vcpkg/installed/arm64-android/lib
cargo:include=/home/user/vcpkg/installed/arm64-android/include
rerun-if-changed=/home/user/.cargo/git/checkouts/magnum-opus-4bb999f3bcbf6ab0/79be072/opus_ffi.h
rerun-if-changed=/home/user/vcpkg/installed/arm64-android/include
```
Erwägen Sie, `vcpkg` in Ihrem Homeverzeichnis zu installieren und dann auszuführen:
```
pushd $HOME
sudo wget https://github.com/rustdesk/doc.rustdesk.com/releases/download/console/dep.tar.gz
sudo tar xzf dep.tar.gz
popd
2023-07-15 14:29:36 +02:00
```
2023-03-08 22:41:52 +01:00
### Bau der Flutter-Rust-Bridge deaktivieren
Möglicherweise müssen Sie den Bau der Flutter-Rust-Bridge in der Datei `build.rs` deaktivieren, indem Sie dies ausführen:
```
sed -i "s/gen_flutter_rust_bridge();/\/\//g" build.rs
```
### RustDesk-Bibliothek bauen
In diesem Schritt erstellen Sie die Datei `librustdesk.so`.
Zuerst fügen Sie `triplet` zu Rust hinzu:
```
rustup target add aarch64-linux-android
```
Dann installieren Sie `cargo-ndk`. Es wird benötigt, um die Datei `librustdesk.so` zu erzeugen:
```
2023-01-14 23:01:18 +01:00
cargo install cargo-ndk
2023-03-08 22:41:52 +01:00
```
2023-01-14 23:01:18 +01:00
2023-03-13 14:58:57 +01:00
Jetzt ist es an der Zeit, `ndk_arm64.sh` auszuführen. Dieses Skript enthält Code, der Rust für Flutter baut. Es benötigt `NDK` in der Version `r23c`.
2023-03-08 22:41:52 +01:00
2023-03-13 14:58:57 +01:00
Sie können es [hier](https://dl.google.com/android/repository/android-ndk-r23c-linux.zip) herunterladen und manuell installieren oder dieser [Anleitung](https://developer.android.com/studio/projects/install-ndk) folgen. Diese Datei ist recht umfangreich, sodass dieser Vorgang eine Weile dauern kann, was hauptsächlich von Ihrer Internetverbindung abhängt.
2023-03-08 22:41:52 +01:00
Denken Sie daran, die Variable **ANDROID_NDK_HOME** zu setzen und zu überprüfen, ob sie gültig ist.
Dann starten Sie einfach:
```
./flutter/ndk_arm64.sh
2023-01-14 23:01:18 +01:00
```
2023-03-08 22:41:52 +01:00
### Generierte Bibliothek in das Verzeichnis `jniLibs` verschieben
Wenn Sie `librustdesk.so` generiert haben, erstellen Sie das richtige Verzeichnis:
```
mkdir -p ./flutter/android/app/src/main/jniLibs/arm64-v8a
```
Und kopieren Sie diese einfach dorthin:
```
2023-03-09 12:27:58 +01:00
cp ./target/aarch64-linux-android/release/liblibrustdesk.so ./flutter/android/app/src/main/jniLibs/arm64-v8a/librustdesk.so
2023-03-08 22:41:52 +01:00
```
### RustDesk erstellen
Im letzten Schritt werden Sie Ihre Version der RustDesk-App erstellen.
Wenn Sie alles richtig gemacht haben, werden Sie es mit Leichtigkeit bauen können.
Zuerst müssen Sie `so.tar.gz` herunterladen:
```
pushd flutter
sudo wget -O so.tar.gz https://github.com/rustdesk/doc.rustdesk.com/releases/download/console/so.tar.gz
```
Dann entpacken Sie es:
```
tar xzvf so.tar.gz
popd
```
Wir verwenden vorübergehend `debug sign config`:
```
sed -i "s/signingConfigs.release/signingConfigs.debug/g" ./flutter/android/app/build.gradle
```
Dann müssen Sie die Datei `librustdesk.so` in das richtige Verzeichnis kopieren:
```
mkdir -p ./flutter/android/app/src/main/jniLibs/arm64-v8a
2023-04-25 22:05:16 +02:00
cp ./target/aarch64-linux-android/release/liblibrustdesk.so ./flutter/android/app/src/main/jniLibs/arm64-v8a/librustdesk.so
2023-03-08 22:41:52 +01:00
```
Jetzt bauen wir endlich Flutter:
```
pushd flutter
flutter build apk --release --target-platform android-arm64 --split-per-abi
```
{{% notice note %}}
Bei diesem Schritt könnten Sie einige Fehler wie `incompatible version of Kotlin` oder `Runtime JAR files in the classpath should have the same version` im Terminal sehen. Das ist normal.
Wenn das Ergebnis `✓ Built build/app` lautet, dann ignorieren Sie es. Es bedeutet nur, dass Sie Ihre App erfolgreich gebaut haben.
{{% /notice %}}
2023-01-14 23:01:18 +01:00
2023-03-08 22:41:52 +01:00
### Optional
Wenn Sie möchten, können Sie die erstellte App verschieben:
2023-01-14 23:01:18 +01:00
```
2023-03-08 22:41:52 +01:00
mv build/app/outputs/flutter-apk/app-arm64-v8a-release.apk ../rustdesk-release.apk
2023-01-14 23:01:18 +01:00
```