Erste Schritte

RayCraft Free stammt von nuget.org. RayCraft Complete stammt aus einem privaten NuGet-Feed und erfordert eine aktive Lizenz und einen Zugriffstoken.

1. RayCraft Free

dotnet add package RayCraft.Blazor

2. RayCraft Complete

Der Feed ist https://nuget.raycraft.dev/v3/index.json, der Benutzername ist rcf und das Kennwort ist Ihr Token (er beginnt mit rcf_).

• 1
  Token erstellen

  Melden Sie sich bei auth.raycraft.dev an, öffnen Sie Paketzugriff und erstellen Sie einen Token. Er wird nur einmal angezeigt, kopieren Sie ihn daher sofort. Sie können bis zu 10 Token pro Lizenz haben; ein widerrufener Token funktioniert sofort nicht mehr.

• 2
  Feed auf Ihrem Rechner hinzufügen

  Der Befehl speichert die Quelle in Ihrer benutzerbezogenen nuget.config, nicht im Projekt.

dotnet nuget add source https://nuget.raycraft.dev/v3/index.json --name RayCraft --username rcf --password <YOUR_TOKEN> --store-password-in-clear-text

--store-password-in-clear-text ist unter Linux, macOS und auf Build-Agents nötig. Unter Windows können Sie es weglassen; das Kennwort wird dann für Ihren Benutzer verschlüsselt.

Build-Server

Legen Sie im Repository eine nuget.config ab, die den Token aus einer Variablen liest, und hinterlegen Sie RAYCRAFT_FEED_TOKEN als Geheimnis in Ihrem Build-System.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="RayCraft" value="https://nuget.raycraft.dev/v3/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <RayCraft>
      <add key="Username" value="rcf" />
      <add key="ClearTextPassword" value="%RAYCRAFT_FEED_TOKEN%" />
    </RayCraft>
  </packageSourceCredentials>
</configuration>

Pakete installieren

dotnet add package RayCraft.Blazor.Complete --source RayCraft
dotnet restore

Registrieren und verwenden

In Program.cs (bei WebAssembly und Auto auch im Client-Projekt):

using RayCraft.Blazor;
using RayCraft.Blazor.Office;

builder.Services.AddRayCraft();
builder.Services.AddRayCraftOffice();

Legen Sie in Components/App.razor das Design auf html fest und fügen Sie die Dateien hinzu:

<html lang="en" data-raycraft-theme="light">
<head>
    <link rel="stylesheet" href="_content/RayCraft.Blazor/css/raycraft.css" />
    <link rel="stylesheet" href="_content/RayCraft.Blazor.Office/css/raycraft-office.css" />
</head>
<body>
    <Routes @rendermode="InteractiveServer" />
    <script src="_content/RayCraft.Blazor/raycraft.js"></script>
    <script src="_framework/blazor.web.js"></script>
</body>
</html>

In Components/_Imports.razor:

@using RayCraft.Blazor
@using RayCraft.Blazor.Components

Die Steuerelemente können danach direkt verwendet werden, zum Beispiel <ThemeMenu />, <DialogHost /> und <SnackbarHost />. Die Zeile AddRayCraftOffice und das Office-Stylesheet werden nur mit dem Office-Paket benötigt.

Zugriff prüfen

Ohne Token antwortet der Feed mit 401; das zeigt, dass die Adresse stimmt und der Zugriff geschützt ist. Mit Token eine schreibgeschützte Prüfung:

curl -s -u rcf:$RAYCRAFT_FEED_TOKEN https://nuget.raycraft.dev/v3/index.json

Erwartet: JSON mit version und einer Liste resources.

Häufige Probleme

Bei allen anderen Fragen schreiben Sie an support@raycraft.dev mit Paketname und -version, Plattform, .NET-Version und den Feed-Zeilen aus dotnet restore -v d (ohne den Token).