ファイルベースのアプリ

この記事は、.NET 10 SDK 以降のバージョン ✔️ 適用されます

ファイルベースのアプリを使用すると、従来のプロジェクトファイルを作成することなく、1 つの C# ファイルから .NET アプリケーションをビルド、実行、発行できます。従来の .NET プロジェクトに代わる軽量の代替手段を提供します。このアプローチにより、スクリプト、ユーティリティ、および小規模アプリケーションの開発が簡略化されます。 .NET SDK は、ソースファイル内のディレクティブに基づいて、必要なプロジェクト構成を自動的に生成します。

主な利点は次のとおりです。

簡単な適用のための減らされた定型文。
埋め込み構成を持つ自己完結型ソースファイル。
네이티브 AOT 발행은 기본값으로 활성화되어 있습니다.
.NET ツールとしての自動パッケージ化。

この記事では、ファイルベースのアプリを効果的に作成、構成、操作する方法について説明します。

サポートされているディレクティブ

ファイルベースのアプリでは、ビルドを構成してアプリケーションを実行するために、 #: のプレフィックスが付いたディレクティブを使用します。サポートされるディレクティブには、 #:package、 #:project、 #:property、および #:sdkが含まれます。これらのディレクティブを C# ファイルの先頭に配置します。

`#:package`

NuGet パッケージ参照をアプリケーションに追加します。

#:package Newtonsoft.Json
#:package Serilog version="3.1.1"

`#:project`

プロジェクトファイルを含む別のプロジェクトファイルまたはディレクトリを参照します。

#:project ../SharedLibrary/SharedLibrary.csproj

`#:property`

MSBuild プロパティ値を設定します。

#:property TargetFramework=net10.0
#:property PublishAot=false

`#:sdk`

使用する SDK を指定します。既定値は Microsoft.NET.Sdk です。

#:sdk Microsoft.NET.Sdk.Web

CLI コマンド

.NET CLI では、使い慣れたコマンドを使用してファイルベースのアプリを完全にサポートします。

アプリケーションの実行

dotnet run コマンドを使用して、ファイルベースのアプリを直接実行します。

dotnet run file.cs

または、短縮形の構文を使用します。

dotnet file.cs

引数を渡す

いくつかの方法でアプリケーションに引数を渡します。

dotnet run file.cs -- arg1 arg2

--後の引数は、アプリケーションに渡されます。 --を指定しない場合、引数は dotnet run コマンドに移動します。

dotnet run file.cs arg1 arg2

ただし、省略形構文では、すべての引数がアプリケーションに渡されます。

dotnet file.cs arg1 arg2

アプリケーションをビルドする

dotnet build コマンドを使用して、ファイルベースのアプリをコンパイルします。

dotnet build file.cs

SDK によって一時的なプロジェクトが生成され、アプリケーションがビルドされます。

ビルド出力をクリーンアップする

dotnet clean コマンドを使用してビルド成果物を削除します。

dotnet clean file.cs

ディレクトリ内のすべてのファイルベースのアプリをクリーンアップします。

dotnet clean file-based-apps

アプリケーションを発行する

dotnet publish コマンドを使用してデプロイパッケージを作成します。

dotnet publish file.cs

ファイルベースのアプリでは、既定でネイティブ AOT 発行が有効にされ、最適化された自己完結型の実行可能ファイルが生成されます。

パッケージ化してツールとする

dotnet pack コマンドを使用して、ファイルベースのアプリを .NET ツールとしてパッケージ化します。

dotnet pack file.cs

ファイルベースのアプリは、既定で PackAsTool=true 設定されます。

プロジェクトに変換する

dotnet project convert コマンドを使用して、ファイルベースのアプリを従来のプロジェクトに変換します。

dotnet project convert file.cs

このコマンドは、同等の SDK とプロパティを持つ .csproj ファイルを作成します。すべての # ディレクティブは、 .cs ファイルから削除され、対応する .csproj ファイル内の要素に変換されます。

依存関係を復元する

dotnet restore コマンドを使用して、ファイルで参照されている NuGet パッケージを復元します。

dotnet restore file.cs

復元は、アプリケーションをビルドまたは実行するときに暗黙的に実行されます。

既定の含まれる項目

ファイルベースのアプリには、コンパイルとパッケージ化のための特定のファイルの種類が自動的に含まれます。

既定では、次の項目が含まれます。

単一の C# ファイル自体。
同じディレクトリ内の ResX リソースファイル。

さまざまな SDK には、他のファイルの種類が含まれます。

Microsoft.NET.Sdk.Web には、 *.json 構成ファイルが含まれています。
その他の特殊な SDK には、他のパターンが含まれる場合があります。

ネイティブ AOT の発行

ファイルベースのアプリでは、既定でネイティブの事前コンパイル (AOT) が有効になります。この機能により、起動速度が速くメモリ占有領域が小さい、最適化された自己完結型の実行可能ファイルが生成されます。

ネイティブ AOT を無効にする必要がある場合は、次の設定を使用します。

#:property PublishAot=false

ネイティブ AOT の詳細については、「ネイティブ AOT のデプロイ」を参照してください。

ユーザーシークレット

ファイルベースのアプリでは、完全なファイルパスのハッシュに基づいて、安定したユーザーシークレット ID が生成されます。この ID を使用すると、ソースコードとは別に機密性の高い構成を格納できます。

従来のプロジェクトと同じ方法でユーザーシークレットにアクセスします。

dotnet user-secrets set "ApiKey" "your-secret-value" --project file.cs

詳細については、「開発中のアプリシークレットの安全なストレージ」を参照してください。

起動プロファイル

ファイルベースのアプリでは、開発中にアプリケーションを実行する方法を構成するための起動プロファイルがサポートされます。ファイルベースのアプリでは、起動プロファイルを Properties/launchSettings.jsonに配置する代わりに、ソースファイルと同じディレクトリに [ApplicationName].run.json という名前のフラット起動設定ファイルを使用できます。

フラット起動設定ファイル

アプリケーションにちなんだ起動設定ファイルを作成します。たとえば、ファイルベースのアプリが app.csされている場合は、同じディレクトリに app.run.json を作成します。

{
  "profiles": {
    "http": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

複数のファイルベースのアプリ

同じディレクトリに複数のファイルベースのアプリがある場合、各アプリは独自の起動設定ファイルを持つことができます。

📁 myapps/
├── foo.cs
├── foo.run.json
├── bar.cs
└── bar.run.json

プロファイルの選択

.NET CLI は、次の優先順位を使用して起動プロファイルを選択します。

--launch-profile オプションで指定されたプロファイル。
DOTNET_LAUNCH_PROFILE環境変数で指定されたプロファイル。
起動設定ファイルで定義されている最初のプロファイル。

特定のプロファイルで実行するには:

dotnet run app.cs --launch-profile https

従来の起動設定

ファイルベースのアプリは、従来の Properties/launchSettings.json ファイルもサポートしています。両方のファイルが存在する場合は、従来の場所が優先されます。両方のファイルが存在する場合、.NET CLI は警告をログに記録して、どのファイルが使用されているかを明確にします。

シェルの実行

shebang 行と実行可能なアクセス許可を使用して、Unix に似たシステムでファイルベースのアプリを直接実行できるようにします。

ファイルの先頭に shebang を追加します。

#!/usr/bin/env dotnet
#:package Spectre.Console

using Spectre.Console;

AnsiConsole.MarkupLine("[green]Hello, World![/]");

ファイルを実行可能にする:

chmod +x file.cs

直接実行します。

./file.cs

暗黙的なビルドファイル

ファイルベースのアプリでは、同じディレクトリまたは親ディレクトリ内の MSBuild および NuGet 構成ファイルが考慮されます。これらのファイルは、SDK によるアプリケーションのビルド方法に影響します。ファイルベースのアプリを整理するときは、これらのファイルに注意してください。

`Directory.Build.props`

ディレクトリツリー内のすべてのプロジェクトに適用される MSBuild プロパティを定義します。ファイルベースのアプリは、これらのプロパティを継承します。

`Directory.Build.targets`

MSBuild ターゲットとカスタムビルドロジックを定義します。ファイルベースのアプリは、ビルド中にこれらのターゲットを実行します。

`Directory.Packages.props`

NuGet 依存関係の中央パッケージ管理を有効にします。ファイルベースのアプリでは、一元管理されたパッケージバージョンを使用できます。

`nuget.config`

NuGet パッケージのソースと設定を構成します。ファイルベースのアプリは、パッケージを復元するときにこれらの構成を使用します。

`global.json`

使用する .NET SDK のバージョンを指定します。ファイルベースのアプリでは、このバージョンの選択が優先されます。

ビルドキャッシュ

.NET SDK は、後続のビルドのパフォーマンスを向上させるためにビルド出力をキャッシュします。ファイルベースのアプリは、このキャッシュシステムに参加します。

キャッシュの動作

SDK は、次に基づいてビルド出力をキャッシュします。

ソースファイルの内容。
ディレクティブの設定。
SDK バージョン。
暗黙的なビルドファイル。

キャッシュを使用するとビルドのパフォーマンスが向上しますが、次の場合に混乱を招く可能性があります。

暗黙的なビルドファイルを変更しても、再構築はトリガーされません。
ファイルを別のディレクトリに移動してもキャッシュは無効になりません。

対処方法

--no-cache フラグを使用して完全ビルドを実行します。
```
dotnet build file.cs --no-cache
```
キャッシュをバイパスするようにクリーンビルドを強制します。
```
dotnet clean file.cs
dotnet build file.cs
```

フォルダーレイアウトに関する推奨事項

ファイルベースのアプリを慎重に整理して、従来のプロジェクトや暗黙的なビルドファイルとの競合を回避します。

プロジェクトファイルの円錐を避ける

ファイルベースのアプリは、 .csproj プロジェクトのディレクトリ構造内に配置しないでください。プロジェクトファイルの暗黙的なビルドファイルと設定は、ファイルベースのアプリに干渉する可能性があります。

❌ お勧めしません。

📁 MyProject/
├── MyProject.csproj
├── Program.cs
└──📁 scripts/
    └── utility.cs  // File-based app - bad location

✅ 推奨：

📁 MyProject/
├── MyProject.csproj
└── Program.cs
📁 scripts/
└── utility.cs  // File-based app - good location

暗黙的なファイルに注意する

親ディレクトリ内の暗黙的なビルドファイルは、サブディレクトリ内のすべてのファイルベースのアプリに影響します。異なるビルド構成が必要な場合は、ファイルベースのアプリ用の分離ディレクトリを作成します。

❌ お勧めしません。

📁 repo/
├── Directory.Build.props  // Affects everything below
├── app1.cs
└── app2.cs

✅ 推奨：

📁 repo/
├── Directory.Build.props
├──📁 projects/
│   └── MyProject.csproj
└──📁 scripts/
    ├── Directory.Build.props  // Isolated configuration
    ├── app1.cs
    └── app2.cs

こちらも参照ください

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-17

次の方法で共有

ファイル ベースのアプリ