ant-design-blazor/docs/getting-started.zh-CN.md
2021-02-23 15:30:46 +08:00

67 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
order: 1
title: 快速上手
---
Ant Design of Blazor 致力于提供给程序员**愉悦**的开发体验。
> 在开始之前,推荐先学习 [Blazor](https://docs.microsoft.com/zh-cn/aspnet/core/blazor/?WT.mc_id=DT-MVP-5003987) 和 [.Net Core](https://docs.microsoft.com/zh-cn/dotnet?WT.mc_id=DT-MVP-5003987),并正确安装和配置了 [.NET Core SDK](https://dotnet.microsoft.com/download?WT.mc_id=DT-MVP-5003987) 3.1.300 或以上。官方指南假设你已了解关于 HTML、CSS 和 JavaScript 的初级知识,并且已经完全掌握了 Blazor 的正确开发方式。如果你刚开始学习.NET 或者 Blazor将 UI 框架作为你的第一步可能不是最好的主意。
## 第一个本地实例
实际项目开发中,你会需要对 C# 代码的构建、调试、代理、打包部署等一系列工程化的需求。
我们强烈建议使用官方的 Visual Studio 2019 或者 VS Code 进行开发,下面我们用一个简单的实例来说明。
### 创建一个 Blazor WebAssembly 项目
> 在创建项目之前,请确保 `.NET Core SDK 3.1.300+` 已被成功安装。
执行以下命令,`dotnet cli` 会在当前目录下新建一个名称为 `PROJECT-NAME` 的文件夹,并自动安装好相应依赖。
```bash
$ dotnet new blazorwasm -o PROJECT-NAME
```
### 开发调试
一键启动调试,运行成功后显示模板页面。
```bash
$ dotnet run
```
### 构建和部署
```bash
$ dotnet publish -c release -o dist
```
入口文件会构建到 `dist/wwwroot` 目录中,你可以自由部署到不同环境中进行引用。
### 安装组件
```bash
$ dotnet add package AntDesign
```
### 引入样式
#### 使用样式与脚本
`wwwroot/index.html` 中引入了
```html
<link href="_content/AntDesign/css/ant-design-blazor.css" rel="stylesheet" />
<script src="_content/AntDesign/js/ant-design-blazor.js"></script>
```
然后在 Razor 模板中使用:
```html
<Button Type="primary">Primary</Button>
```