Primeiros passos

O RayCraft Free vem do nuget.org. O RayCraft Complete vem de um feed NuGet privado e requer uma licença ativa e um token de acesso.

1. RayCraft Free

dotnet add package RayCraft.Blazor

2. RayCraft Complete

O feed é https://nuget.raycraft.dev/v3/index.json, o nome de usuário é rcf e a senha é o seu token (ele começa com rcf_).

• 1
  Criar um token

  Entre em auth.raycraft.dev, abra Acesso aos pacotes e crie um token. Ele é mostrado apenas uma vez, portanto copie-o imediatamente. Você pode ter até 10 tokens por licença; um token revogado deixa de funcionar na hora.

• 2
  Adicionar o feed no seu computador

  O comando grava a origem no nuget.config do seu usuário, não no projeto.

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 é necessário no Linux, no macOS e em agentes de build. No Windows você pode omiti-lo e a senha é criptografada para o seu usuário.

Servidor de build

Coloque no repositório um nuget.config que leia o token de uma variável e defina RAYCRAFT_FEED_TOKEN como segredo no seu sistema de build.

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

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

Registrar e usar

Em Program.cs (no WebAssembly e no Auto, também no projeto cliente):

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

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

Em Components/App.razor defina o tema em html e adicione os arquivos:

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

Em Components/_Imports.razor:

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

Depois os controles podem ser usados diretamente, por exemplo <ThemeMenu />, <DialogHost /> e <SnackbarHost />. A linha AddRayCraftOffice e a folha de estilos do Office só são necessárias com o pacote Office.

Verificar o acesso

Sem token, o feed responde 401, o que mostra que o endereço está correto e o acesso está protegido. Com token, uma verificação somente de leitura:

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

Esperado: JSON com version e uma lista resources.

Problemas comuns

Para qualquer outro assunto, escreva para support@raycraft.dev com o nome e a versão do pacote, a plataforma, a versão do .NET e as linhas do feed de dotnet restore -v d (sem o token).