Стъпки за настройка
- Създайте проект
Blazor Server, WebAssembly или Auto на .NET 10. - Инсталирайте пакета
Добавете NuGet пакета RayCraft.Blazor и приемете лиценза (EULA), когато бъдете попитани. - Регистрирайте услугите
Извикайте AddRayCraft() в Program.cs, в сървърния и в клиентския проект. - Свържете стиловете и скрипта
Добавете стиловия файл и скрипта към страницата си. Библиотеката не оцветява тялото на страницата, затова задайте цветовете ѝ чрез нейните токени. - Изберете тема
Задайте data-raycraft-theme на елемента html като начална тема и я сменяйте по-късно с RayCraft.setTheme('light') или RayCraft.setTheme('dark'). Скриптът възстановява запазения избор или системната тема. - Добавете първата си контрола
Добавете @using RayCraft.Blazor.Components към страницата (не към _Imports в стандартния шаблон, където NavMenu съществува два пъти) и ползвайте контролата като всеки Razor компонент. Интерактивните контроли изискват интерактивен режим на рендиране. - Диалози и съобщения
Само ако ползвате диалози или снекбарове, поставете DialogHost и SnackbarHost по веднъж във вашия layout.
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 идва от частния канал на RayCraft, а не от nuget.org. Нужни са лиценз (или 14-дневният пробен период) и токен за изтегляне от профила ви.
- Вземете лиценз и токен
Влезте в auth.raycraft.dev, започнете 14-дневния пробен период (без карта) или купете лиценз, после отворете Package access и създайте токен. Задайте го като RAYCRAFT_FEED_TOKEN, а RAYCRAFT_FEED_USER задайте на произволен непразен текст. - Добавете канала
Сложете показания тук nuget.config до решението си. Съпоставянето на източниците праща имената на пакетите на Complete само към канала на RayCraft. - Инсталирайте пакетите
RayCraft.Blazor.Complete съдържа контролите. RayCraft.Blazor.Complete.Office добавя контролите за документи, електронни таблици, презентации и PDF. - Разпознаване на текст (по избор)
RayCraft.Blazor.Complete.Office.Ocr.Tesseract и неговият .Data пакет разпознават текст в сканирани PDF страници. Работят само на Windows. - Не смесвайте с Free
RayCraft.Blazor (Free) и RayCraft.Blazor.Complete имат еднакви имена на асемблита и пространства. Никога не инсталирайте и двата в едно приложение; сменете пакета и запазете AddRayCraft(). - Вашият лиценз, вашите версии
В кода ви няма лицензен ключ. След крайната дата запазвате всяка версия, издадена дотогава. Възстановяване на сума е възможно в рамките на 7 дни от покупката.
<!-- 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