Pasos de configuración
- Crear un proyecto
Blazor Server, WebAssembly o Auto en .NET 10. - Instalar el paquete
Añade el paquete NuGet RayCraft.Blazor y acepta la licencia (EULA) cuando te la pidan. - Registrar los servicios
Llama a AddRayCraft() en Program.cs, en el servidor y en el proyecto cliente. - Enlazar los estilos y el script
Añade la hoja de estilos y el script a tu página. La biblioteca no colorea el cuerpo de la página, así que define los colores de la página con sus tokens. - Elegir un tema
Define data-raycraft-theme en el elemento html como tema inicial y cámbialo después con RayCraft.setTheme('light') o RayCraft.setTheme('dark'). El script restaura la elección guardada o el tema del sistema. - Añadir tu primer control
Añade @using RayCraft.Blazor.Components a la página (no a _Imports en la plantilla por defecto, donde NavMenu existe dos veces) y usa el control como cualquier componente Razor. Los controles interactivos necesitan un modo de renderizado interactivo. - Diálogos y mensajes
Solo si usas diálogos o snackbars, coloca DialogHost y SnackbarHost una vez en tu diseño.
dotnet add package RayCraft.Blazor
// Program.cs (server and client)
builder.Services.AddRayCraft();
<!-- App.razor -->
<html data-raycraft-theme="light">
<link rel="stylesheet" href="_content/RayCraft.Blazor/css/raycraft.css" />
<script src="_content/RayCraft.Blazor/raycraft.js"></script>
/* your own css */
body { background: var(--raycraft-bg); color: var(--raycraft-text); }
@* Counter.razor *@
@using RayCraft.Blazor.Components
@rendermode InteractiveServer
<Button OnClick="Increment">Clicked @count times</Button>
@code {
private int count;
private void Increment() => count++;
}RayCraft Complete
RayCraft Complete llega desde el feed privado de RayCraft, no desde nuget.org. Necesita una licencia (o la prueba de 14 días) y un token de descarga de tu cuenta.
- Obtén una licencia y un token
Inicia sesión en auth.raycraft.dev, empieza la prueba de 14 días (sin tarjeta) o compra una licencia, abre Package access y crea un token. Defínelo como RAYCRAFT_FEED_TOKEN, y RAYCRAFT_FEED_USER con cualquier texto que no esté vacío. - Añadir el feed
Coloca el nuget.config mostrado aquí junto a tu solución. La asignación de orígenes envía los nombres de paquete de Complete solo al feed de RayCraft. - Instalar los paquetes
RayCraft.Blazor.Complete contiene los controles. RayCraft.Blazor.Complete.Office añade los controles de documentos, hojas de cálculo, presentaciones y PDF. - Reconocimiento de texto (opcional)
RayCraft.Blazor.Complete.Office.Ocr.Tesseract y su paquete .Data reconocen texto en páginas PDF escaneadas. Solo funcionan en Windows. - No mezclar con Free
RayCraft.Blazor (Free) y RayCraft.Blazor.Complete tienen los mismos nombres de ensamblado y de espacio de nombres. No instales nunca ambos en una aplicación; cambia el paquete y conserva AddRayCraft(). - Tu propia licencia, tus propias versiones
No hay clave de licencia en tu código. Tras la fecha de fin conservas todas las versiones publicadas hasta entonces. Es posible un reembolso en los 7 días siguientes a una compra.
<!-- nuget.config next to your solution -->
<configuration>
<packageSources>
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
<add key="raycraft" value="https://nuget.raycraft.dev/v3/index.json" />
</packageSources>
<packageSourceCredentials>
<raycraft>
<add key="Username" value="%RAYCRAFT_FEED_USER%" />
<add key="ClearTextPassword" value="%RAYCRAFT_FEED_TOKEN%" />
</raycraft>
</packageSourceCredentials>
<packageSourceMapping>
<packageSource key="nuget.org"><package pattern="*" /></packageSource>
<packageSource key="raycraft"><package pattern="RayCraft.Blazor.Complete*" /></packageSource>
</packageSourceMapping>
</configuration>
dotnet add package RayCraft.Blazor.Complete
dotnet add package RayCraft.Blazor.Complete.Office