Zum Hauptinhalt springen

Ruyi-Pakete verwalten

Aktualisieren des lokalen Paket-Cache

Holen Sie sich den Inhalt der entfernten Softwarequelle und aktualisieren Sie den lokalen Paket-Cache. Standardmäßig wird das auf GitHub gehostete Spiegelbild verwendet:

bash
$ ruyi update

Der Paket-Cache wird im Benutzerverzeichnis gespeichert, normalerweise unter ~/.cache/ruyi/packages-index/; wenn die Umgebungsvariable XDG_CACHE_HOME gesetzt ist, befindet sich das Verzeichnis unter $XDG_CACHE_HOME/ruyi/packages-index/.

ruyi update fehlgeschlagen

Da die aktuellen Paketindexinformationen im GitHub-Repository gehostet werden, kann es bei instabilen Repository-Zugriffen erforderlich sein, in der Konfigurationsdatei ein alternatives Repository zu konfigurieren.

Die Konfigurationsdatei des RuyiSDK-Paketmanagers wird standardmäßig unter ~/.config/ruyi/config.toml gespeichert, wenn XDG_CONFIG_HOME konfiguriert ist, befindet sie sich unter $XDG_CONFIG_HOME/ruyi/config.toml. Wenn die Datei nicht existiert, können Sie sie selbst erstellen.

text
[repo]
local = ""
remote = "https://mirror.iscas.ac.cn/git/ruyisdk/packages-index.git"
branch = "main"

Dabei steht local für das lokale Cache-Verzeichnis, remote für die Adresse des entfernten Spiegelservers und branch für den Git-Zweig, in dem sich das Spiegelbild befindet.

Speichern Sie die Konfiguration und versuchen Sie erneut, den lokalen Cache zu aktualisieren:

bash
$ ruyi update

Nachrichten lesen

Als Sie im vorherigen Abschnitt ruyi update ausgeführt haben, um die lokale Softwarequelle zu aktualisieren, haben Sie wahrscheinlich gesehen, dass der RuyiSDK-Paketmanager ungelesene Nachrichten (news item(s)) aufgelistet hat. Hier können Sie rechtzeitig über die Aktualisierungen der Ruyi-Pakete oder andere wichtige Mitteilungen informiert werden.

Durch Ausführen von ruyi news list können Sie ebenfalls diese Seite aufrufen. Der Unterschied besteht darin, dass alle Nachrichten angezeigt werden, während ungelesene Nachrichten in unterstützten Terminals grün hervorgehoben werden.

Sie können die folgenden Befehle verwenden, um Nachrichten zu durchsuchen, zu lesen und als gelesen zu markieren:

bash
$ ruyi news list -h
$ ruyi news list
$ ruyi news list --new        # Nur ungelesene Nachrichten auflisten

$ ruyi news read -h
$ ruyi news read 1            # Nachricht mit der ID 1 lesen
$ ruyi news read              # Alle ungelesenen Nachrichten lesen
$ ruyi news read --quiet      # Nichts ausgeben, nur ungelesene Nachrichten als gelesen markieren

Ruyi markiert ungelesene Nachrichten, indem es die Titel in ~/.local/state/ruyi/news.read.txt speichert. Wenn XDG_STATE_HOME konfiguriert ist, befindet sich der Dateipfad unter $XDG_STATE_HOME/ruyi/news.read.txt.

Pakete auflisten

Ruyi-Pakete sind grob in mehrere Kategorien unterteilt:

  • toolchain Werkzeugkette
  • source Quellpaket
  • emulator Emulator
  • board-image Systemabbild
  • analyzer Analysetools
  • extra Sonstiges

Die Versionsnummern der Pakete folgen strikt den Semver-Richtlinien, was bedeutet, dass sie von den upstream-Versionen abweichen können.

Pakete werden in offiziell veröffentlichte Pakete und Vorabversionen (prerelease) unterteilt. Vorabversionen werden vor der offiziellen Veröffentlichung dieser Version durch upstream bereitgestellt, beheben jedoch Bugs der zuletzt veröffentlichten Version.

Einige früh veröffentlichte Ruyi-Pakete haben auch slug eingeführt, um Versionen zu kennzeichnen. Dies ist ein veraltetes Feature, das in Zukunft vollständig entfernt wird.

Verwenden Sie den Befehl ruyi list, um alle verfügbaren Pakete aufzulisten. Beachten Sie, dass selbst wenn ein Paket/eine Version nicht mit dem aktuellen Systemarchitektur kompatibel ist, es dennoch aufgelistet wird.

Hier ist ein Beispiel auf einer x86_64-Maschine; die tatsächliche Liste wird länger sein:

bash
$ ruyi list
List of available packages:

* source/milkv-duo-examples
  - 0.20240719.0+git.52ae647a (latest)
* source/ruyisdk-demo
  - 0.20231114.0 (latest)
* source/coremark
  - 1.0.2-pre.20230125 (prerelease, latest-prerelease)
  - 1.0.1 (latest)
* toolchain/llvm-plct
  - 17.0.6-ruyi.20240511 (latest)
* toolchain/llvm-upstream
  - 17.0.5-ruyi.20231121 (latest) slug: llvm-upstream-20231121
* toolchain/gnu-milkv-milkv-duo-elf-bin
  - 0.20240731.0+git.67688c7335e7 (latest)
* analyzer/dynamorio-riscv
  - 10.93.19979-ruyi.20240914 (latest, no binary for current host)
  - 10.0.19748-ruyi.20240128 (no binary for current host)
* board-image/uboot-revyos-sipeed-lc4a-8g
  - 0.20240127.0 (latest)
* board-image/uboot-oerv-sipeed-lpi4a-8g
  - 0.2309.1 (latest)
* board-image/canmv-linux-sdk-demo-canaan-k230d-rv64ilp32
  - 0.20240731.0 (latest)
  - 0.20240717.0 ()
* emulator/qemu-user-riscv-xthead
  - 6.1.0-ruyi.20231207+g03813c9fe8 (latest)
* emulator/box64-upstream
  - 0.3.1-pre.ruyi.20240901+git.9178effd (prerelease, latest-prerelease, no binary for current host)
  - 0.3.0-ruyi.20240718 (latest, no binary for current host)
  - 0.2.9-pre.ruyi.20240702+git.4b0b3fc9 (prerelease, no binary for current host)
  - 0.2.8-ruyi.20240702 (no binary for current host)
* emulator/qemu-user-riscv-upstream
  - 8.2.0-ruyi.20240128 (latest)
  - 8.1.2-ruyi.20231121 ()
* extra/wps-office
  - 12.1.0-r.17900 (latest)
  - 12.1.0-r.17885 ()

Der Befehl list bietet auch die Parameter --verbose oder -v an, um detailliertere Informationen auszugeben, was fast alle Informationen aus der Softwarequelle druckt. Da die Ausgabe sehr lang sein kann, wird empfohlen, die Ausgabe in eine Datei oder in Tools wie less umzuleiten.

Zeilen wie toolchain/llvm-plct stellen den Namen eines Pakets dar, der bei der Verwendung des install-Befehls angegeben werden muss. In den meisten Fällen reicht es aus, nur den Namen nach dem / anzugeben, in diesem Beispiel also llvm-plct.

Nach dem Paketnamen folgt eine Liste von Versionsnummern. Diese Versionsnummern können verwendet werden, um eine bestimmte Version eines Pakets oder eine Version, die dem angegebenen Ausdruck entspricht, zu installieren. Der Inhalt in Klammern hinter der Versionsnummer kennzeichnet einige Informationen zu dieser Version.

latest

Kennzeichnet die neueste Version eines Pakets, die auch die Version ist, die standardmäßig mit dem install-Befehl installiert wird.

prerelease

Eine Vorabversion. Dies bedeutet, dass dieses Paket diese Version vor der Veröffentlichung durch upstream bereitgestellt hat. Neue Versionen beheben oft Bugs der alten Version, insbesondere wenn eine Vorabversion als notwendig erachtet wird.

Standardmäßig ignoriert der RuyiSDK-Paketmanager Vorabversionen. Sie können den RuyiSDK-Paketmanager so konfigurieren, dass Vorabversionen installiert werden, müssen jedoch die damit verbundenen Risiken selbst tragen.

latest-prerelease

Die neueste Vorabversion. Wenn die Installation von Vorabversionen erlaubt ist und diese Version neuer ist als die latest-Version, wird dies die Version sein, die standardmäßig mit dem install-Befehl installiert wird.

Wenn Sie tatsächlich eine Vorabversion installieren müssen, können Sie die Konfiguration in der Konfigurationsdatei hinzufügen:

text
[packages]
prereleases = true

no binary for current host

Dies bedeutet, dass für diese Paketversion kein Binärpaket für die lokale Architektur bereitgestellt wird.

In bestimmten Szenarien sollten Pakete, die nicht für die lokale Architektur bestimmt sind, installiert werden, z. B. wenn Sie box64 auf einer riscv64-Maschine verwenden, um WPS Office auszuführen.

In diesem Fall können Sie angeben, dass ein Binärpaket für eine bestimmte Architektur installiert werden soll:

bash
$ ruyi install --host x86_64 wps-office

Installation von Binärpaketen

In der Regel sind die Pakete in den folgenden Kategorien Binärpakete:

  • toolchain Werkzeugkette
  • emulator Emulator
  • board-image Systemabbild
  • analyzer Analysetools
  • extra Sonstiges

Diese Pakete können mit dem install-Befehl installiert werden, z. B. um die GNU upstream gcc-Werkzeugkette zu installieren:

bash
$ ruyi install gnu-upstream
$ ruyi install toolchain/gnu-upstream

Die oben genannte Methode zur Installation durch Angabe des Paketnamens installiert standardmäßig das als latest gekennzeichnete gnu-upstream-Paket. Wenn Sie eine bestimmte ältere Version von gnu-upstream installieren möchten, können Sie dies durch Angabe der Version tun:

bash
$ ruyi install 'gnu-upstream(0.20231118.0)'
$ ruyi install 'gnu-upstream(>=0.20231118.0)'

Die Ausdrücke unterstützen die Operatoren <, >, ==, <=, >= und !=.

Wenn Sie mehrere Pakete installieren möchten:

bash
$ ruyi install gnu-plct gnu-upsteam llvm-plct llvm-upstream

In einigen speziellen Fällen, wie z. B. wenn Sie versehentlich Dateien eines installierten Pakets gelöscht haben, können Sie das Paket erneut installieren, um es wiederherzustellen:

bash
$ ruyi install --reinstall gnu-upstream

Die vom Paketmanager heruntergeladenen Pakete werden unter ~/.cache/ruyi/distfiles/ gespeichert. Wenn XDG_CACHE_HOME angegeben ist, befindet sich der Pfad unter $XDG_CACHE_HOME/ruyi/distfiles/. Diese Pakete liegen normalerweise in komprimierter Form vor und müssen mit Systemwerkzeugen entpackt werden. Wenn die entsprechenden Werkzeuge im System fehlen, wird eine entsprechende Warnung ausgegeben.

Der install-Befehl installiert standardmäßig nur Binärpakete, die mit der lokalen Architektur übereinstimmen. Die entpackten Binärpakete werden im Verzeichnis ~/.local/share/ruyi/binaries/$(uname -m)/ gespeichert. Wenn XDG_DATA_HOME angegeben ist, befindet sich der Pfad unter $XDG_DATA_HOME/ruyi/binaries/$(uname -m)/.

Da Systemabbilder ebenfalls Binärdateien sind, kann der install-Befehl auch zum Herunterladen und Entpacken verwendet werden. In der Regel werden diese Pakete jedoch zusammen mit der Flash-Funktion von Ruyi verwendet. Die entpackten Abbilddateien werden im Verzeichnis ~/.local/share/ruyi/blobs/ gespeichert. Wenn XDG_DATA_HOME angegeben ist, befindet sich der Pfad unter $XDG_DATA_HOME/ruyi/blobs/.

Installation von Quellpaketen

Die folgenden Kategorien von Paketen sind offensichtlich Quellpakete:

  • source Quellpaket

Mit extract laden Sie ein Quellpaket herunter und entpacken es. Standardmäßig legt Ruyi dafür ein Unterverzeichnis mit Paketname und Version an:

bash
$ ruyi extract ruyisdk-demo
$ cd ruyisdk-demo-0.20231114.0
$ ls
README.md  rvv-autovec

Mit --extract-without-subdir entpacken Sie das Paket direkt ins aktuelle Verzeichnis. Das war in früheren Versionen die Standardeinstellung:

bash
$ ruyi extract --extract-without-subdir ruyisdk-demo
$ ls
README.md  rvv-autovec

Mit --dest-dir oder -d geben Sie ein anderes Zielverzeichnis an:

bash
$ ruyi extract -d /path/to/destination ruyisdk-demo

Mit --fetch-only oder -f laden Sie das Paket herunter, ohne es zu entpacken:

bash
$ ruyi extract -f ruyisdk-demo

Der extract-Befehl unterstützt die gleichen Versionsausdrücke wie der install-Befehl.

Deinstallation von Paketen

Mit ruyi uninstall deinstallieren Sie ein einzelnes Paket:

bash
$ ruyi uninstall gnu-upstream

ruyi remove und ruyi rm sind Kurzformen desselben Befehls:

bash
$ ruyi remove gnu-upstream
$ ruyi rm gnu-upstream

Wenn Sie alle heruntergeladenen und installierten Pakete löschen möchten, verwenden Sie:

bash
$ ruyi self clean --distfiles --installed-pkgs

Wenn Sie eine Toolchain entfernen, funktionieren bestehende virtuelle Umgebungen mit dieser Toolchain nicht mehr. Beim Aktivieren zeigt Ruyi dafür keine Warnung an.