Blazor를 사용하여 ASP.NET Core로 첫 웹앱을 빌드하세요.
시작
목적
Blazor를 사용하여 ASP.NET Core로 첫 웹앱을 빌드하세요.
필수 구성 요소
없음.
macOS 12.0 이상 버전.
완료 시간
10~15분 + 다운로드/설치 시간
시나리오
간단한 카운터 구성 요소를 만들고, 사용하고, 수정합니다.
다운로드 및 설치
원하는 경우 자습서의 명령줄 인터페이스 버전을 사용하여 Blazor를 시작할 수도 있습니다.
설치하는 동안 ASP.NET 및 웹 개발 워크로드를 선택해야 합니다(위의 설치 링크는 이미 해당 옵션을 미리 선택함).
이미 Visual Studio 2022가 있습니까?
Visual Studio 2022가 이미 있는 경우 최신 상태이고 필요한 워크로드가 설치되어 있는지 확인하세요.
- Windows 로고 키를 선택하고 Visual Studio 설치 관리자를 입력한 다음 Enter 키를 누릅니다.
- 메시지가 표시되면 설치 프로그램이 자체적으로 업데이트하도록 허용합니다.
- Visual Studio 2022에 대한 업데이트를 사용할 수 있는 경우 업데이트 단추가 표시됩니다. 설치를 수정하기 전에 업데이트하려면 선택합니다. 이 자습서는 Visual Studio 2022 17.8 이상 버전에서만 작동합니다.
- Visual Studio 2022 설치를 찾아 수정 버튼을 선택합니다.
- 아직 선택하지 않은 경우 ASP.NET 및 웹 개발 워크로드를 선택하고 수정 버튼을 선택합니다. 그렇지 않으면 대화 창을 닫으세요.
.NET 앱을 빌드하기 시작하려면 .NET SDK를 다운로드하여 설치하세요.
.NET 8 SDK x64(Intel) 다운로드
.NET 8 SDK Arm64(Apple Silicon) 다운로드
Apple M1 또는 M2 칩이 있는 Mac을 사용하는 경우 Arm64 버전의 SDK를 설치해야 합니다.
올바르게 설치된 모든 것을 확인하세요
설치한 후 새 터미널을 열고 다음 명령을 실행합니다.
dotnet --version
설치에 성공한 경우 버전 8.0.100 이상이 출력되어야 합니다.
8.0.100
모든 것이 정상이면 아래의 계속 버튼을 선택하여 다음 단계로 이동합니다.
오류가 있나요?
zsh: 명령을 찾을 수 없음: dotnet 오류가 표시되면 새 터미널 창을 열었는지 확인하세요. 문제를 해결할 수 없는 경우 문제 해결에 대한 도움말을 보려면 문제가 발생했습니다 버튼을 사용하세요.
dotnet: 명령을 찾을 수 없음 오류가 표시되면 새 터미널 창을 열었는지 확인하세요. 문제를 해결할 수 없는 경우 문제 해결에 대한 도움말을 보려면 문제가 발생했습니다 버튼을 사용하세요.
앱 만들기
-
Visual Studio를 시작하고 새 프로젝트 만들기를 선택합니다.
- 새 프로젝트 만들기 창에서 검색 상자에 Blazor를 입력하고 Enter 키를 누릅니다.
-
Blazor 웹앱 템플릿을 선택하고 다음을 선택합니다.
- 새 프로젝트 구성 창에 프로젝트 이름으로 BlazorApp을 입력하고 다음을 선택합니다.
-
아직 선택하지 않은 경우 추가 정보 창의 프레임워크 드롭다운에서 .NET 8.0(장기 지원)을 선택하고 만들기 버튼을 클릭합니다.
Blazor 웹앱을 만들 때 인증 사용 여부, 사용할 대화형 렌더링 모드, 대화형으로 사용할 앱의 양 등 다양한 옵션을 선택할 수 있습니다. 이 앱의 경우 기본값이 다음과 같이 선택되어 있는지 확인하세요.
- 인증 유형: 없음
- 대화형 렌더링 모드: 서버
- 대화형 작업 위치: 페이지/구성 요소당
Visual Studio에서 프로젝트가 만들어지고 로드됩니다. 솔루션 탐색기를 사용하여 프로젝트의 콘텐츠를 살펴보세요.
실행할 준비가 된 간단한 Blazor 앱을 제공하기 위해 여러 파일이 생성되었습니다.
Program.cs
는 서버를 시작하고 앱 서비스와 미들웨어를 구성하는 앱의 진입점입니다.-
Components
디렉터리 내:App.razor
는 앱의 루트 구성 요소입니다.Routes.razor
는 Blazor 라우터를 구성합니다.Pages
디렉터리에는 앱에 대한 몇 가지 예제 웹 페이지가 포함되어 있습니다.
BlazorApp.csproj
는 앱 프로젝트와 해당 종속성을 정의하며 솔루션 탐색기에서 BlazorApp 프로젝트 노드를 두 번 클릭하여 볼 수 있습니다.Properties
디렉터리 내의launchSettings.json
파일은 로컬 개발 환경에 대한 다양한 프로필 설정을 정의합니다. 포트 번호는 프로젝트 생성 시 자동으로 할당되어 이 파일에 저장됩니다.
모든 것이 정상이면 아래의 계속 버튼을 선택하여 다음 단계로 이동합니다.
터미널에서 다음 명령을 실행하여 앱을 만듭니다.
dotnet new blazor -o BlazorApp
이 명령은 새 Blazor 웹앱 프로젝트를 만들고 현재 위치 내의 BlazorApp
라는 새 디렉터리에 배치합니다.
이전 명령으로 만든 새 BlazorApp
디렉터리로 이동합니다.
cd BlazorApp
BlazorApp
디렉터리의 내용을 빠르게 살펴보세요.
ls
실행할 준비가 된 간단한 Blazor 앱을 제공하기 위해 BlazorApp
디렉터리에 여러 파일을 만들었습니다.
Program.cs
는 서버를 시작하고 앱 서비스와 미들웨어를 구성하는 앱의 진입점입니다.-
Components
디렉터리 내:App.razor
는 앱의 루트 구성 요소입니다.Routes.razor
는 Blazor 라우터를 구성합니다.Pages
디렉터리에는 앱에 대한 몇 가지 예제 웹 페이지가 포함되어 있습니다.
BlazorApp.csproj
는 앱 프로젝트와 해당 종속성을 정의합니다.Properties
디렉터리 내의launchSettings.json
파일은 로컬 개발 환경에 대한 다양한 프로필 설정을 정의합니다. 포트 번호는 프로젝트 생성 시 자동으로 할당되어 이 파일에 저장됩니다.
자습서의 뒷부분에서 사용할 BlazorApp
디렉터리 경로를 기록해 둡니다.
모든 것이 정상이면 아래의 계속 버튼을 선택하여 다음 단계로 이동합니다.
앱 실행
Visual Studio의 디버그 도구 모음에서 디버깅 시작 버튼(녹색 화살표)을 클릭하여 앱을 실행합니다.
앱이 실행되면 핫 다시 로드 버튼을 클릭하여 실행 중인 앱에 코드 변경 내용을 적용할 수 있습니다.
상단 도구 모음에서 중지 버튼을 클릭하여 언제든지 앱을 중지할 수 있습니다.
Visual Studio에서 웹앱을 처음 실행하면 HTTPS를 통해 앱을 호스팅하기 위한 개발 인증서가 설정되고 인증서를 신뢰하라는 메시지가 표시됩니다. 인증서를 신뢰하는 데 동의하는 것이 좋습니다. 인증서는 로컬 개발에만 사용되며 인증서가 없으면 대부분의 브라우저에서 웹사이트의 보안에 대해 불평합니다.
브라우저에서 앱이 실행될 때까지 기다립니다. 다음 페이지로 이동하면 첫 번째 Blazor 앱을 성공적으로 실행한 것입니다!
터미널에서 다음 명령을 실행합니다.
dotnet watch
dotnet watch
명령은 앱을 빌드 및 시작한 다음 코드를 변경할 때마다 앱을 업데이트합니다. Ctrl+C를 선택하여 언제든지 앱을 중지할 수 있습니다.
앱에 http://localhost:<port number>에서 수신 대기 중이라고 표시되고 해당 주소에서 브라우저가 시작될 때까지 기다립니다.
앱이 http://localhost:<port number>에서 수신 대기 중임을 표시할 때까지 기다렸다가 브라우저를 열고 해당 주소로 이동합니다.
다음 페이지로 이동하면 첫 번째 Blazor 앱을 성공적으로 실행한 것입니다!
표시된 페이지는 Components/Pages
디렉터리에 있는 Home.razor
파일에 의해 정의됩니다. 내용은 다음과 같습니다.
@page "/"
<PageTitle>Home</PageTitle>
<h1>Hello, world!</h1>
Welcome to your new app.
홈페이지로 설정하고 Hello, world!
와 Welcome to your new app
텍스트를 표시하는 코드를 이미 포함합니다. PageTitle
구성 요소는 브라우저 탭에 표시되도록 현재 페이지의 제목을 설정합니다.
오류가 있나요?
NET::ERR_CERT_INVALID 오류 코드와 함께 "연결이 비공개가 아님"이라는 오류 메시지가 표시되면 브라우저에서 새 인증서를 선택할 수 있도록 모든 브라우저 창을 다시 시작하고 애플리케이션을 다시 실행해 보세요.
발생한 문제를 해결할 수 없는 경우 문제 해결에 대한 도움말을 보려면 아래에 있는 문제가 발생했습니다 버튼을 선택하세요.
카운터 사용해 보기
실행 중인 앱에서 왼쪽 사이드바의 카운터 탭을 클릭하여 카운터 페이지로 이동합니다. 그런 다음 페이지를 표시해야 합니다.
페이지를 새로 고치지 않고 카운트를 늘리려면 나를 클릭하세요 버튼을 선택하세요. 웹 페이지에서 카운터를 증가시키려면 일반적으로 JavaScript를 작성해야 하지만 Blazor에서는 C#을 사용할 수 있습니다.
Components/Pages
디렉터리에 있는 Counter.razor
파일에서 Counter
구성 요소의 구현을 찾을 수 있습니다.
@page "/counter"
@rendermode InteractiveServer
<PageTitle>Counter</PageTitle>
<h1>Counter</h1>
<p role="status">Current count: @currentCount</p>
<button class="btn btn-primary" @onclick="IncrementCount">Click me</button>
@code {
private int currentCount = 0;
private void IncrementCount()
{
currentCount++;
}
}
맨 위의 @page
지시문에 지정된 대로 브라우저에서 /counter
를 요청하면 Counter
구성 요소가 해당 콘텐츠를 렌더링합니다. @rendermode
지시문은 구성 요소에 대해 대화형 서버 렌더링을 사용하도록 설정하여 브라우저에서 사용자 인터페이스 이벤트를 처리할 수 있도록 합니다.
[클릭] 버튼을 선택할 때마다:
onclick
이벤트가 발생합니다.IncrementCount
메서드가 호출됩니다.currentCount
가 증가합니다.- 업데이트된 수를 표시하기 위해 구성 요소가 렌더링됩니다.
구성 요소 추가
각 .razor 파일은 재사용할 수 있는 UI 구성 요소를 정의합니다.
Visual Studio에서 Home.razor
파일을 엽니다. Home.razor
파일이 이미 존재하며 프로젝트를 생성할 때 생성되었습니다. 이전에 만든 BlazorApp
디렉터리 내의 Components/Pages
폴더에 있습니다.
원하는 텍스트 편집기에서 Home.razor
파일을 엽니다. Home.razor
파일이 이미 있으며 dotnet new
명령을 실행했을 때 생성되었습니다. 이전에 만든 BlazorApp
디렉터리 내의 Components/Pages
폴더에 있습니다.
Home.razor
파일 끝에 <Counter />
요소를 추가하여 앱 홈페이지에 Counter
구성 요소를 추가합니다.
@page "/"
<PageTitle>Home</PageTitle>
<h1>Hello, world!</h1>
Welcome to your new app.
<Counter />
핫 다시 로드 버튼을 클릭하여 실행 중인 앱에 변경 내용을 적용합니다. 그러면 Counter
구성 요소가 홈 페이지에 표시됩니다.
이 변경 내용이 저장되면 dotnet watch
명령이 실행 중인 앱에 변경 내용을 적용하여 Counter
구성 요소가 홈 페이지에 표시되도록 합니다.
구성 요소 수정
구성 요소 매개 변수는 특성 또는 자식 콘텐츠를 사용하여 지정되며, 이를 통해 하위 구성 요소에 대한 속성을 설정할 수 있습니다. Counter
구성 요소에 매개 변수를 정의하여 버튼을 클릭할 때마다 증가하는 양을 지정합니다.
[Parameter]
특성을 사용하여IncrementAmount
에 대한 공개 속성을 추가합니다.currentCount
값을 증가시킬 때IncrementAmount
를 사용하도록IncrementCount
메서드를 변경하세요.
다음 코드는 이를 달성하는 방법을 보여줍니다. 강조 표시된 선은 변경 내용을 보여줍니다.
@page "/counter"
@rendermode InteractiveServer
<PageTitle>Counter</PageTitle>
<h1>Counter</h1>
<p role="status">Current count: @currentCount</p>
<button class="btn btn-primary" @onclick="IncrementCount">Click me</button>
@code {
private int currentCount = 0;
[Parameter]
public int IncrementAmount { get; set; } = 1;
private void IncrementCount()
{
currentCount += IncrementAmount;
}
}
Home.razor
에서 <Counter>
요소를 업데이트하여 다음 코드의 강조 표시된 줄에 표시된 것처럼 증분량을 10으로 변경하는 IncrementAmount
특성을 추가합니다.
@page "/"
<PageTitle>Home</PageTitle>
<h1>Hello, world!</h1>
Welcome to your new app.
<Counter IncrementAmount="10" />
핫 다시 로드 버튼을 클릭하여 앱에 변경 내용을 적용합니다. Home
구성 요소에는 다음 이미지와 같이 Click me 버튼이 선택될 때마다 10씩 증가하는 자체 카운터가 있습니다. /counter
의 Counter
구성 요소(Counter.razor
)는 계속 1씩 증가합니다.
Home
구성 요소에는 다음 이미지와 같이 Click me 버튼이 선택될 때마다 10씩 증가하는 자체 카운터가 있습니다. /counter
의 Counter
구성 요소(Counter.razor
)는 계속 1씩 증가합니다.
다음 단계
축하합니다. 첫 번째 Blazor 앱을 빌드하고 실행했습니다!
계속 학습
이제 기본 정보를 학습했으니, 할 일 목록 앱을 빌드할 Microsoft Learn의 Blazor 자가 학습 모듈을 사용하여 첫 번째 Blazor 앱 빌드를 계속하세요.
Microsoft Learn: Blazor 할 일 목록 앱 빌드
초보자용 Blazor
처음부터 끝까지 전체 Blazor 앱을 빌드하는 방법 알아보기:
귀하는 다음 항목에도 또한 관심이 있을 수 있습니다...