Aan de slag

RayCraft Free komt van nuget.org. RayCraft Complete komt uit een privé NuGet-feed en vereist een actieve licentie en een toegangstoken.

1. RayCraft Free

dotnet add package RayCraft.Blazor

2. RayCraft Complete

De feed is https://nuget.raycraft.dev/v3/index.json, de gebruikersnaam is rcf en het wachtwoord is uw token (het begint met rcf_).

• 1
  Een token maken

  Meld u aan op auth.raycraft.dev, open Pakkettoegang en maak een token. Het wordt maar één keer getoond, kopieer het dus meteen. U kunt maximaal 10 tokens per licentie hebben; een ingetrokken token werkt direct niet meer.

• 2
  De feed op uw computer toevoegen

  De opdracht slaat de bron op in het nuget.config van uw gebruiker, niet in het project.

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 is nodig op Linux, macOS en op buildagents. In Windows kunt u het weglaten; het wachtwoord wordt dan voor uw gebruiker versleuteld.

Buildserver

Zet in de repository een nuget.config die het token uit een variabele leest en stel RAYCRAFT_FEED_TOKEN in als geheim in uw buildsysteem.

<?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>

De pakketten installeren

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

Registreren en gebruiken

In Program.cs (bij WebAssembly en Auto ook in het clientproject):

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

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

Stel in Components/App.razor het thema in op html en voeg de bestanden toe:

<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

De besturingselementen kunnen daarna direct worden gebruikt, bijvoorbeeld <ThemeMenu />, <DialogHost /> en <SnackbarHost />. De regel AddRayCraftOffice en het Office-stylesheet zijn alleen nodig met het Office-pakket.

Toegang controleren

Zonder token antwoordt de feed met 401, wat laat zien dat het adres klopt en de toegang beveiligd is. Met token, een controle die alleen leest:

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

Verwacht: JSON met version en een lijst resources.

Veelvoorkomende problemen

Schrijf voor alle andere vragen naar support@raycraft.dev met de naam en versie van het pakket, het platform, de .NET-versie en de feedregels uit dotnet restore -v d (zonder het token).