LoginSignup
3
5
@inakuuun(i _na)

.NET MAUI 環境構築に四苦八苦したときの備忘録

Last updated at Posted at 2023-11-16

環境

  • Windows 10 Pro
  • Visual Studio 2022(v17.7)
  • .NET 7.0.13
  • Visual Studio 17.7.6
  • SDK 7.0.403

参考記事

.NET マルチプラットフォーム アプリ UI 開発ワークロードをインストール

  • 適当にプロジェクトを開いて、「ツール>ツールと機能を取得」をクリック
    image.png
  • .NET マルチプラットフォームアプリのUI開発にチェックを入れて「適用」
    image.png

新しいプロジェクトの作成

  • 新しいプロジェクトの作成をクリック
    image.png

  • .NET MAUIアプリを選択して次へ
    image.png

  • プロジェクト名とソリューション名を任意で設定して次へ
    ※フォルダを作成するまでのパスでかな文字を含まないようにする(後ほど設定するAndroidエミュレーター起動時にビルドできないといったことがあったため)
    image.png

  • フレームワークの選択(今回は.NET 7.0を使用)
    image.png

Windowsアプリを起動

  • フレームワークを選択
    image.png

  • Windowsアプリを起動
    image.png

  • 開発者モードの設定をしていない場合は以下のようなダイアログが表示される
    image.png

  • 開発者モードをONに設定する
    image.png

  • 再度Windowsアプリを起動
    image.png

  • 起動が確認できればOK
    image.png

Androidプラットフォームの環境構築

  • ビルドするプラットフォームとフレームワークを選択(Android)
    image.png

  • Android Emulatorをクリック
    image.png

  • 「同意」
    image.png

  • 「同意」
    image.png

  • 「Yes」
    image.png

  • 「create」
    image.png

Hyper-vを高速化

  • Androidエミュレーターを開始しようとすると以下のように警告が出されるため、Hyper-vの高速化が必要そう。。
    image.png

  • 「Windowsの機能の有効化または無効化」を起動
    image.png

  • [Hyper-V プラットフォーム] と [Windows ハイパーバイザー プラットフォーム] を有効化
    image.png

  • 「ツール>Android>Android SDKマネージャー...」を選択
    image.png

  • 以下の条件で選択されていることを確認

    • Android SDK Tools バージョン 26.1.1 以降
    • Android SDK Platform-Tools 27.0.1 以降
    • Android SDK Build Tools 27.0.3 以降
    • Android Emulator 27.2.7 以降。
      ※今回はAPI33を使用するため、「Android SDK Build-Tools 33」にチェックを入れて「変更を適用」

    image.png

  • 同意
    image.png

  • 作成したAndroidエミュレーターを選択
    image.png

  • 起動
    image.png

  • 起動が確認できればOK
    image.png

Androidアプリの起動がうまくいかなかった時に試したこと

Visual Studioのアップデート

Visual Studioをアップデートが決め手だったように感じる
image.png

SDKの更新があったので更新

image.png

全てのライセンスへ同意

image.png

dotnetワークロードの更新

# インストールしているワークロードを確認
dotnet workload list

# note2プロジェクトに必要なワークロードをインストールし、不要なワークロードを削除
dotnet workload restore notes2.csproj

# maui-Androidがないよーと出力されていた時にインストール
dotnet workload install maui-android

Androidを起動する時にパスに全角があると起動しなかったため、プロジェクトをCドライブ直下やDドライブ直下に移動することで解消できました。

image.png

Visual Studioをアップデート後、「デバッグするには、プロジェクトを配置する必要があります。構成マネージャーで配置を有効にしてください。」といったエラーになった時の対処

image.png

  • 下記のようなエラーメッセージが出力されている時
    • 結論から言うとリビルドするだけでOK

エラー DEP0700: アプリの登録に失敗しました。[0x80073CF6] AppxManifest.xml(33,27): エラー 0x80070003: スプラッシュ スクリーン イメージ [SplashScreen.png] が見つからないため、パッケージ chhlvl.designIT7_xzp7k71ajzmr6 をインストールまたは更新できません。パッケージにアプリケーションのスプラッシュ スクリーンとして使用できるイメージが含まれていること、およびパッケージ マニフェストがこのスプラッシュ スクリーン イメージが存在するパッケージ内の正しい場所を指していることを確認します。デザインIT7

  • 以下の記事に詳細を記載しておきました

起動できない場合や配置エラーなど...

  • Androidデバイスマネージャーを一度削除
    image.png

  • エミュレーターを再作成
    image.png

現状、Microsoft公式の手順通りに進めても.NET MAUIの起動時にエラーが起こると考えておいた方が良いと思います。自分の場合は.NET マルチプラットフォームアプリのUI開発ワークロードをすでに入れている状態だったため、様々なエラーと闘う必要がありました。
皆さんの環境構築がうまくいくことを祈っています。

3
5
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
3
5