Konfigurowanie edytora notatek

Utwórz mały projekt WinUI 3, a następnie skopiuj do niego kod z tych tematów. Nie musisz klonować repozytorium ani pobierać kompletnego przykładu. Jeśli masz już aplikację WinUI 3, dostosuj konfigurację poniżej i zachowaj istniejącą tożsamość, zasoby i nawigację aplikacji.

Tworzenie projektu

Skorzystaj z konfiguracji WinUI z poziomu wiersza polecenia, aby zainstalować zestaw SDK platformy .NET 10 i szablony WinUI. Z katalogu, w którym są zachowywane projekty, utwórz projekt o nazwie LocalNotes:

dotnet new winui-mvvm -n LocalNotes --dotnet-version net10.0 --target-platform-min-version 10.0.26100.0
Set-Location LocalNotes

Szablon aplikacji WinUI MVVM dostarcza manifest aplikacji, zasoby, stronę, model wyświetlania i profile publikowania specyficzne dla architektury. Nazwa projektu ma znaczenie, ponieważ kod w tym samouczku używa przestrzeni nazw LocalNotes.

Wygenerowany LocalNotes.csproj kod można otworzyć w Visual Studio 2026 r. lub kontynuować w edytorze. Wybierz arm64 na komputerze Arm64 lub x64 na komputerze Intel lub AMD. Nie wybieraj opcji Dowolny procesor CPU: środowisko uruchomieniowe wnioskowania zawiera biblioteki natywne specyficzne dla architektury.

Konfigurowanie projektu

W przypadku nowego projektu LocalNotes zastąp zawartość pliku LocalNotes.csproj następującym kodem. Zachowaj foldery Assets i app.manifest wygenerowane przez szablon oraz Package.appxmanifest i Properties\PublishProfiles.

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net10.0-windows10.0.26100.0</TargetFramework>
    <TargetPlatformMinVersion>10.0.26100.0</TargetPlatformMinVersion>
    <RootNamespace>LocalNotes</RootNamespace>
    <ApplicationManifest>app.manifest</ApplicationManifest>
    <Platforms>ARM64;x64</Platforms>
    <Platform Condition="'$(Platform)' == '' or '$(Platform)' == 'AnyCPU'">ARM64</Platform>
    <RuntimeIdentifiers>win-arm64;win-x64</RuntimeIdentifiers>
    <PublishProfile>win-$(Platform).pubxml</PublishProfile>
    <UseWinUI>true</UseWinUI>
    <WinUISDKReferences>false</WinUISDKReferences>
    <EnableMsixTooling>true</EnableMsixTooling>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <Content Include="Assets\SplashScreen.scale-200.png" />
    <Content Include="Assets\LockScreenLogo.scale-200.png" />
    <Content Include="Assets\Square150x150Logo.scale-200.png" />
    <Content Include="Assets\Square44x44Logo.scale-200.png" />
    <Content Include="Assets\Square44x44Logo.targetsize-24_altform-unplated.png" />
    <Content Include="Assets\Square44x44Logo.targetsize-48_altform-lightunplated.png" />
    <Content Include="Assets\StoreLogo.png" />
    <Content Include="Assets\AppIcon.ico" />
    <Content Include="Assets\Wide310x150Logo.scale-200.png" />
  </ItemGroup>

  <ItemGroup>
    <Manifest Include="$(ApplicationManifest)" />
  </ItemGroup>

  <!--
    Defining the "Msix" ProjectCapability here allows the Single-project MSIX Packaging
    Tools extension to be activated for this project even if the Windows App SDK Nuget
    package has not yet been restored.
  -->
  <ItemGroup Condition="'$(DisableMsixProjectCapabilityAddedByProject)'!='true' and '$(EnableMsixTooling)'=='true'">
    <ProjectCapability Include="Msix" />
  </ItemGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AI.Foundry.Local.WinML" Version="1.2.4" />
    <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.28000.2705" />
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="2.4.0" />
    <PackageReference Include="CommunityToolkit.Mvvm" Version="8.4.2" />
  </ItemGroup>

  <!--
    Defining the "HasPackageAndPublishMenuAddedByProject" property here allows the Solution
    Explorer "Package and Publish" context menu entry to be enabled for this project even if
    the Windows App SDK Nuget package has not yet been restored.
  -->
  <PropertyGroup Condition="'$(DisableHasPackageAndPublishMenuAddedByProject)'!='true' and '$(EnableMsixTooling)'=='true'">
    <HasPackageAndPublishMenu>true</HasPackageAndPublishMenu>
  </PropertyGroup>

  <!-- Publish Properties -->
  <PropertyGroup>
    <PublishReadyToRun Condition="'$(Configuration)' == 'Debug'">False</PublishReadyToRun>
    <PublishReadyToRun Condition="'$(Configuration)' != 'Debug'">True</PublishReadyToRun>
    <PublishTrimmed Condition="'$(Configuration)' == 'Debug'">False</PublishTrimmed>
    <PublishTrimmed Condition="'$(Configuration)' != 'Debug'">False</PublishTrimmed>
  </PropertyGroup>

  <!-- Foundry Core 1.2.4 bundles an older copy of this DLL as well as depending
       on the WinML package. Keep the dependency's DLL once in the MSIX payload. -->
  <Target Name="RemoveDuplicateFoundryWinML" AfterTargets="ResolvePackageAssets">
    <ItemGroup>
      <NativeCopyLocalItems Remove="@(NativeCopyLocalItems)"
          Condition="'%(NativeCopyLocalItems.NuGetPackageId)' == 'Microsoft.AI.Foundry.Local.Core.WinML' and '%(NativeCopyLocalItems.Filename)%(NativeCopyLocalItems.Extension)' == 'Microsoft.Windows.AI.MachineLearning.dll'" />
    </ItemGroup>
  </Target>
</Project>

Zweryfikowane wersje to Microsoft.AI.Foundry.Local.WinML 1.2.4, Microsoft.WindowsAppSDK 2.4.0 i CommunityToolkit.Mvvm 8.4.2. Użyj wersji pokazanych tutaj, a nie uaktualniaj pakietów podczas wykonywania instrukcji.

Note

W tych wersjach pakietów zarówno pakiet Foundry Core, jak i jego zależność Windows ML dostarczają Microsoft.Windows.AI.MachineLearning.dll. Element docelowy RemoveDuplicateFoundryWinML usuwa z zasobów pakietu tylko zbędną kopię Foundry, pozostawiając kopię zależności. Bez tego spakowana wersja może zakończyć się błędem APPX1101. Zweryfikuj ponownie ten cel zależny od wersji podczas aktualizowania zależności.

Zachowaj Package.appxmanifest i spakowaną konfigurację uruchamiania. Polecenie tworzenia projektu ustawia minimalną wersję systemu Windows na kompilację 26100. Nie potrzebujesz funkcji systemAIModels ani tokenu dostępu Phi Silica, aby korzystać z tej funkcji narzędzia Foundry Local.

Kompilowanie i otwieranie aplikacji

W Visual Studio wybierz profil uruchamiania programu LocalNotes (pakiet) i naciśnij klawisz F5. Jeśli używasz terminalu z zainstalowanym zestawem SDK .NET 10 i aplikacją winapp, skompiluj i uruchom dla swojej architektury:

dotnet build LocalNotes.csproj -c Debug -p:Platform=ARM64
winapp run .\bin\ARM64\Debug\net10.0-windows10.0.26100.0\win-arm64 --detach --json

Na komputerze x64 zastąp ciąg ARM64 ciągiem x64 i win-arm64win-x64. winapp run uruchamia aplikację z użyciem tożsamości pakietu; nie uruchamiaj bezpośrednio skompilowanego pliku wykonywalnego. Są to polecenia programowania lokalnego, a nie instrukcje dotyczące tworzenia podpisanego dystrybucyjnego pliku MSIX.

W tym punkcie kontrolnym aplikacja nadal wyświetla stronę początkową szablonu. Upewnij się, że zostanie otwarty, a następnie zamknij go przed edycją plików w następnym temacie. Nie dodano jeszcze edytora notatek ani elementów sterujących konfiguracją modelu i nie powinno dojść do pobrania modelu.

Note

Przywracanie narzędzia NuGet pobiera zależności aplikacji podczas kompilacji. Oddzielna akcja konfiguracji modelu w uruchomionej aplikacji pobiera pliki modelu. Są to różne pliki do pobrania, przeznaczone do różnych celów.

Dodawanie zależności do istniejącej aplikacji

Jeśli dostosowujesz istniejącą aplikację zamiast tworzyć program LocalNotes, najpierw skompiluj i uruchom aplikację bez sztucznej inteligencji. Następnie z katalogu zawierającego swój projekt w języku C# dodaj zestaw SDK specyficzny dla Windows:

dotnet add package Microsoft.AI.Foundry.Local.WinML

W tym samouczku użyto biblioteki MVVM Toolkit do obsługi właściwości obserwowalnych i poleceń asynchronicznych. Dodaj go, jeśli projekt jeszcze się do niego nie odwołuje:

dotnet add package CommunityToolkit.Mvvm

Porównaj konfigurację projektu powyżej z platformą docelową aplikacji, obsługiwaną wersją Windows i odwołaniami do pakietu. Połącz odpowiednie ustawienia, zamiast zastępować identyfikator, zasoby, ustawienia podpisywania lub nawigację istniejącego projektu.

Polecenia bez określenia wersji wybierają aktualnie stabilne pakiety. Aby dokładnie odtworzyć tę instrukcję, użyj zamiast tego wersji pakietów z powyższego kodu XML. W przypadku korzystania z Foundry Local WinML 1.2.4 w aplikacji pakietowanej należy również zachować pokazany powyżej obiekt docelowy zduplikowanych zasobów o wąskim zakresie.

W tym samouczku jest wykorzystywany natywny zestaw SDK działający w procesie. Nie instalujesz lokalnego interfejsu wiersza polecenia usługi Foundry, nie uruchamiasz jej usługi, wybierasz port hosta lokalnego ani nie konfigurujesz punktu końcowego chmury OpenAI. Betalgo.Ranul.OpenAI Typy komunikatów używane w usłudze są dostarczane jako przechodnia zależność zestawu SDK. Ich przestrzeń nazw nie oznacza przykładowych wywołań usługi w chmurze. Aby zapoznać się z innymi opcjami integracji, zobacz dokumentację lokalnego zestawu SDK rozwiązania Foundry.

Zidentyfikuj granicę funkcji

Notatka stanowi dane wejściowe; podsumowanie stanowi oddzielne dane wyjściowe. Konfiguracja modelu odbywa się po akcji użytkownika, a generowanie jest uruchamiane dopiero po pomyślnym zakończeniu instalacji. Aplikacja nadal działa jako edytor tekstów, jeśli model nie jest gotowy.

W następnym kroku utworzysz usługę i zastąpisz model widoku startowego i stronę. Każdy blok kodu zawiera całą zawartość pliku o podanej nazwie, w tym deklaracje przestrzeni nazw i dyrektywy using. Skopiuj wszystkie pliki przed ponownym zbudowaniem, aby strona, polecenia i cykl życia okna były powiązane.