Ćwiczenie — odwołanie do pakietu z aplikacji

Ukończone

W tej lekcji uzyskasz nowy kod Tailspin.SpaceGame.Web zawierający usunięte klasy modeli. Zamiast odwoływać się bezpośrednio do modeli, kod odwołuje się do nich z pakietu utworzonego w poprzedniej lekcji.

Oto lista kroków:

• Pobierz nowy kod z gałęzi oryginalnego repozytorium Tailspin.SpaceGame.Web.
• Odwołuje się do nowego pakietu Models w wersji 1.0.0.
• Aby wyszukać ten pakiet w kanale informacyjnym usługi Azure Artifacts, zmień potok kompilacji.
• Zobacz, jak potok pomyślnie skompiluje aplikację.

Pobierz gałąź z GitHub

Pobierz gałąź models-package z GitHub i przełącz się na tę gałąź.

Ta gałąź zawiera projekt Space Game, z którym pracowano w poprzednich modułach, ale katalog Models został usunięty.

1. Przejdź do kopii programu Visual Studio Code, która pokazuje projekt Tailspin.SpaceGame.Web.

2. W terminalu, aby pobrać gałąź o nazwie models-package z repozytorium Firmy Microsoft, uruchom następujące polecenia git. Następnie przejdź do tej gałęzi.

   git fetch upstream models-package
   git checkout -B models-package upstream/models-package
   

   Format tych poleceń umożliwia pobranie kodu początkowego z repozytorium Firmy Microsoft w witrynie GitHub znanej jako upstream. Wkrótce załadujesz tę gałąź do swojego repozytorium GitHub o nazwie origin.

3. W ramach opcjonalnego kroku sprawdź, czy katalog Models nie istnieje już w Eksploratorze plików. Zamiast tego powinieneś mieć kontrolery , widoki oraz inne katalogi.

Odwołanie do pakietu Models

1. Otwórz plik Tailspin.SpaceGame.Web.csproj i dodaj następujący ItemGroup:

   <ItemGroup>
     <PackageReference Include="Tailspin.SpaceGame.Web.Models" Version="1.0.0" />
   </ItemGroup>
   

   Pamiętaj, aby umieścić ItemGroup wewnątrz węzła Project. Plik powinien wyglądać podobnie do następującego:

   <Project Sdk="Microsoft.NET.Sdk.Web">
   
     <PropertyGroup>
       <TargetFramework>net6.0</TargetFramework>
       <ProjectGuid>{A0C4E31E-AC75-4F39-9F59-0AA19D9B8F46}</ProjectGuid>
     </PropertyGroup>
   
     <ItemGroup>
       <PackageReference Include="Tailspin.SpaceGame.Web.Models" Version="1.0.0" />
     </ItemGroup>
   
     <ItemGroup>
       <Folder Include="wwwroot\images\avatars\" />
     </ItemGroup>
   </Project>
   

2. Zmodyfikuj wersję "1.0.0", aby uwzględnić prefiks wersji wstępnej wygenerowany podczas procesu kompilacji. Oto przykład:

   <PackageReference Include="Tailspin.SpaceGame.Web.Models" Version="1.0.0-CI-20200610-165738" />
   

   Odwołuje się to do pakietu Tailspin.SpaceGame.Web.Models, który utworzyłeś w usłudze Azure Artifacts. Zwróć uwagę na numer wersji 1.0.0 oraz sufiks wersji wstępnej. Odpowiada to początkowej wersji, którą opublikowano w usłudze Azure Artifacts w poprzedniej części kursu.

3. Zapisz plik.

   Notatka

   Podczas zapisywania pliku program Visual Studio Code może poprosić o przywrócenie zależności. Wybierz przycisk Przywróć, aby przywrócić zależności.

Modyfikowanie konfiguracji potoku

Gałąź models-package zawiera początkowy plik azure-pipelines.yml. Tutaj zmodyfikujesz konfigurację potoku, aby pobrać pakiet Tailspin.SpaceGame.Web.Models z usługi Azure Artifacts.

1. W programie Visual Studio Code otwórz azure-pipelines.yml.

2. Zmodyfikuj azure-pipelines.yml, jak pokazano poniżej:

   trigger:
   - '*'
   
   pool:
     vmImage: 'ubuntu-20.04'
     demands:
     - npm
   
   variables:
     buildConfiguration: 'Release'
     wwwrootDir: 'Tailspin.SpaceGame.Web/wwwroot'
     dotnetSdkVersion: '6.x'
   
   steps:
   - task: UseDotNet@2
     displayName: 'Use .NET SDK $(dotnetSdkVersion)'
     inputs:
       version: '$(dotnetSdkVersion)'
   
   - task: NuGetToolInstaller@0
     inputs:
       versionSpec: '5.9.1'
   
   - task: Npm@1
     displayName: 'Run npm install'
     inputs:
       verbose: false
   
   - script: './node_modules/.bin/node-sass $(wwwrootDir) --output $(wwwrootDir)'
     displayName: 'Compile Sass assets'
   
   - task: gulp@1
     displayName: 'Run gulp tasks'
   
   - script: 'echo "$(Build.DefinitionName), $(Build.BuildId), $(Build.BuildNumber)" > buildinfo.txt'
     displayName: 'Write build info'
     workingDirectory: $(wwwrootDir)
   
   - task: NuGetCommand@2
     displayName: 'Restore project dependencies'
     inputs:
       command: 'restore'
       restoreSolution: '**/*.sln'
       feedsToUse: 'select'
       vstsFeed: '$(System.TeamProject)/Tailspin.SpaceGame.Web.Models'
   
   - task: DotNetCoreCLI@2
     displayName: 'Build the project - $(buildConfiguration)'
     inputs:
       command: 'build'
       arguments: '--no-restore --configuration $(buildConfiguration)'
       projects: '**/*.csproj'
   
   - task: DotNetCoreCLI@2
     displayName: 'Publish the project - $(buildConfiguration)'
     inputs:
       command: 'publish'
       projects: '**/*.csproj'
       publishWebProjects: false
       arguments: '--no-build --configuration $(buildConfiguration) --output $(Build.ArtifactStagingDirectory)/$(buildConfiguration)'
       zipAfterPublish: true
   
   - task: PublishBuildArtifacts@1
     displayName: 'Publish Artifact: drop'
     condition: succeeded()
   

   Wyróżniony kod pokazuje, gdzie potok przywraca zależności i wyszukuje źródło danych usługi Azure Artifacts dla zależności, które mogą tam znajdować się.

3. Przygotowywanie, zatwierdzanie i wypychanie zmian do usługi GitHub.

   git add .
   git commit -m "Add reference to Models package"
   git push origin models-package
   

4. Przejdź do usługi Azure Pipelines i obejrzyj przebieg kompilacji. Kompilacja pobiera pakiet Models z usługi Azure Artifacts i kompiluje projekt pomyślnie.