Primeros pasos

RayCraft Free se obtiene de nuget.org. RayCraft Complete se obtiene de un feed NuGet privado y requiere una licencia activa y un token de acceso.

1. RayCraft Free

dotnet add package RayCraft.Blazor

2. RayCraft Complete

El feed es https://nuget.raycraft.dev/v3/index.json, el usuario es rcf y la contraseña es su token (empieza por rcf_).

• 1
  Crear un token

  Inicie sesión en auth.raycraft.dev, abra Acceso a paquetes y cree un token. Solo se muestra una vez, así que cópielo de inmediato. Puede tener hasta 10 tokens por licencia; un token revocado deja de funcionar al instante.

• 2
  Agregar el feed en su equipo

  El comando guarda el origen en el nuget.config de su usuario, no en el proyecto.

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 es necesario en Linux, macOS y en agentes de compilación. En Windows puede omitirlo y la contraseña se cifra para su usuario.

Servidor de compilación

Confirme en el repositorio un nuget.config que lea el token de una variable y defina RAYCRAFT_FEED_TOKEN como secreto en su sistema de compilación.

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

Instalar los paquetes

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

Registrar y usar

En Program.cs (en WebAssembly y Auto, también en el proyecto cliente):

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

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

En Components/App.razor defina el tema en html y agregue los archivos:

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

En Components/_Imports.razor:

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

Después los controles se pueden usar directamente, por ejemplo <ThemeMenu />, <DialogHost /> y <SnackbarHost />. La línea AddRayCraftOffice y la hoja de estilos de Office solo hacen falta con el paquete Office.

Comprobar el acceso

Sin token, el feed responde 401, lo que demuestra que la dirección es correcta y el acceso está protegido. Con token, una comprobación de solo lectura:

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

Resultado esperado: JSON con version y una lista resources.

Problemas frecuentes

Para cualquier otra consulta escriba a support@raycraft.dev con el nombre y la versión del paquete, la plataforma, la versión de .NET y las líneas del feed de dotnet restore -v d (sin el token).