Kom igång

RayCraft Free hämtas från nuget.org. RayCraft Complete hämtas från ett privat NuGet-flöde och kräver en aktiv licens och en åtkomsttoken.

1. RayCraft Free

bash

dotnet add package RayCraft.Blazor

2. RayCraft Complete

Flödet är https://nuget.raycraft.dev/v3/index.json, användarnamnet är rcf och lösenordet är token (den börjar med rcf_).

1
Skapa en token
Logga in på auth.raycraft.dev, öppna Paketåtkomst och skapa en token. Den visas bara en gång, så kopiera den direkt. Det kan finnas upp till 10 token per licens; en återkallad token slutar fungera omedelbart.
2
Lägg till flödet på datorn
Kommandot sparar källan i användarens nuget.config, inte i projektet.

bash

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 behövs i Linux, macOS och på build-agenter. I Windows kan det utelämnas och lösenordet krypteras då för användaren.

Håll token hemlig. Lägg den inte i förvaret, i en incheckad nuget.config eller i e-post till supporten (de sista 4 tecknen räcker).

Byggserver

Lägg en nuget.config i förvaret som läser token från en variabel, och ange RAYCRAFT_FEED_TOKEN som hemlighet i byggsystemet.

xml

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

Installera paketen

bash

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

Paket	Vad det används till
`RayCraft.Blazor.Complete`	Komponenter, format och skript (huvudpaketet).
`RayCraft.Blazor.Complete.Office`	Kontroller för dokument, kalkylblad, presentationer och PDF. Kräver huvudpaketet.
`RayCraft.Blazor.Complete.Editor`	Rich text-redigerare (HTML, Markdown, JSON och e-post). Kräver huvudpaketet.
`RayCraft.Blazor.Complete.Office.Ocr.Tesseract`	Valfritt: textigenkänning i skannade PDF-sidor (endast Windows). Kräver Office.
`RayCraft.Blazor.Complete.Office.Ocr.Tesseract.Data`	Språkmodeller för det föregående paketet.

Installera inte den kostnadsfria RayCraft.Blazor i samma applikation som Complete: de har samma assembly- och namnrymdsnamn. Paketen fungerar med Server, WebAssembly och Auto.

Registrera och använd

I Program.cs (vid WebAssembly och Auto även i klientprojektet):

csharp

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

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

Ange temat på html i Components/App.razor och lägg till filerna:

html

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

I Components/_Imports.razor:

razor

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

Kontrollerna kan sedan användas direkt, till exempel <ThemeMenu />, <DialogHost /> och <SnackbarHost />. Raden AddRayCraftOffice och Office-formatmallen behövs bara med Office-paketet.

Mallen dotnet new blazor har sin egen Components/Layout/NavMenu.razor med samma taggnamn som paketets NavMenu, och bygget stoppas med RZ9985. Ta bort den och ta bort användningen av den från MainLayout.razor.

Kontrollera åtkomsten

Utan token svarar flödet 401, vilket visar att adressen är rätt och åtkomsten skyddad. Med token, en skrivskyddad kontroll:

bash

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

Förväntat: JSON med version och en lista resources.

Vanliga problem

Symptom	Orsak
401 eller 403 vid restore	Token har återkallats, licensen är inte aktiv eller en annan källa med samma namn ersätter flödet.
Paketet hittades inte	Versionen gavs ut efter att licensen löpt ut: förnya eller använd en äldre version.
Fungerar lokalt, inte på byggservern	Token-variabeln är inte angiven.

Skriv till support@raycraft.dev med paketets namn och version, plattform, .NET-version och flödesraderna från dotnet restore -v d (utan token).

Skicka synpunkterVersion 1.0.3