Repository navigation
Development Environment
ここでは、SRdeck本体とプラグインをビルド・テストするための環境を整えます。利用者としての導入手順はインストール、新規プラグインの最短手順は最初のプラグインを参照してください。
最初に、ビルドするソースとソリューションを確認してください。
| ビルド対象 | 必要な環境 |
|---|---|
公開 SRdeckPlugins の SRdeckPlugins.sln
|
Windows x64、.NET 10 SDK、対応する版のプラットフォーム NuGet パッケージ4個。公開プラグインのビルドは CMake を呼び出しません |
公開 SRdeck の SRdeck.sln
|
上記の OS / SDK と、以下の C++ / Windows SDK / CMake。プラットフォームライブラリは同梱ソースからビルドします |
開発用統合リポジトリの SRdeck.sln
|
ホストの要件に加え、AribT98 の C ネイティブ CODEC と AribT61 の Rust / Cargo ツールチェーン |
公開プラグインの復元・ビルドコマンドとパッケージの配置は、取得した SRdeckPlugins の
README.ja.md を参照してください。ホストもソースからビルドする場合には、以下のネイティブ環境が必要です。
| ツール | 用途 |
|---|---|
| Windows x64 | ホストとWPFプラグインの実行 |
| .NET 10 SDK | restore、build、test、pack |
| Visual Studio/Rider/VS Code(任意) | C#、WPF、デバッグ。CLI ビルドだけなら IDE は不要 |
| CMake 3.21以上(VS 2022)/4.2以上(VS 2026) | ホストのCPU/GPUネイティブ部品、開発用 AribT98 CODEC |
| Visual Studio / Build Tools の C++ ツール | MSVC x64ネイティブビルド。VS 2022 は v143、VS 2026 は v145 |
| Windows 10 / 11 SDK | Windows API ヘッダー、ライブラリ、リソースコンパイラー |
| Rust stable / Cargo(統合リポジトリのみ) | AribT61 CODEC。x86_64-pc-windows-msvc ツールチェーン |
| Git(ZIP取得なら不要) | ソース取得と差分管理 |
| インターネット接続 | 初回の NuGet / Cargo 依存関係の復元 |
ホストとWPFプラグインはnet10.0-windows、Contracts、SDK、SignalProcessing、ヘッドレスサンプルはnet10.0を対象にします。公式プラットフォームはx64、RIDはwin-x64です。
Visual Studio Installer で Visual Studio または Build Tools の「変更」を開き、 **「C++ によるデスクトップ開発」**ワークロードを選択します。インストールの詳細で次を確認してください。
- MSVC の x64/x86 ビルドツール(VS 2022: v143、VS 2026: v145)
- Windows 10 SDK または Windows 11 SDK
- Windows 用 C++ CMake ツール(別途 CMake をインストールする場合は省略可能)
C# 用のワークロードや VS Code の C/C++ 拡張機能だけでは、MSVC と Windows SDK はそろいません。 Microsoft のインストール手順も参照してください。
CMakeLists.txt の最小バージョンは3.20ですが、Windows の Visual Studio ジェネレーターには
別の要件があります。VS 2022 用は3.21で追加、
VS 2026 用は4.2で追加されています。
インストール後に PowerShell を開き直して確認します。以下は PowerShell 用です。
dotnet --info
cmake --version
cmake --help
git --versiondotnet --info で .NET 10 SDK、cmake --version で使用する CMake の版、
cmake --help の Generators 欄で使用する Visual Studio が表示されることを確認します。
Visual Studio 同梱の CMake が PATH にない場合は、C++ ツールが入ったインストールを探し、次のように指定できます。
$vswhere = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe"
$vs = & $vswhere -latest -products '*' -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath
# $vs が空なら、先に C++ ビルドツールを追加してください。
$env:CMAKE_EXE = Join-Path $vs 'Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin\cmake.exe'
& $env:CMAKE_EXE --version
$env:PATH = "$(Split-Path $env:CMAKE_EXE);$env:PATH"別途インストールした CMake を使う場合は、CMAKE_EXE にその cmake.exe のフルパスを指定します。
ホストの自動ビルドはこの環境変数を使用します。AribT98 と手動の cmake コマンドにも
同じ CMake を使用させるには、上記のように PATH へ追加してください。
統合リポジトリをビルドする場合は cargo --version と rustup show も確認してください。
ソースのルートで、インストール済みの Visual Studio を指定します。VS 2026 の場合は値を
Visual Studio 18 2026 に置き換えてください。この指定は後続の dotnet build にも適用されます。
$env:CMAKE_GENERATOR = 'Visual Studio 17 2022'
cmake -S .\SRdeck\native\sr_fft -B .\artifacts\native-check\sr_fft -A x64
cmake --build .\artifacts\native-check\sr_fft --config Releaseこの例はホストのソースがある場合に実行します。新しい出力フォルダーでコンパイラーと Windows SDK を 確認でき、通常のビルドに残った CMake キャッシュの影響を避けられます。
| 最初のエラー | 確認・対処 |
|---|---|
cmake が見つからない/終了コード9009 |
CMake をインストールし、PATH または上記の CMAKE_EXE を設定 |
Could not create named generator/Visual Studio のインスタンスが見つからない |
CMake と VS の版の組み合わせ、C++ ワークロードを確認。CMAKE_GENERATOR はインストール済みの VS を指定 |
CMAKE_C_COMPILER / CMAKE_CXX_COMPILER が未設定/コンパイラーの確認に失敗 |
MSVC x64/x86 ツールと Windows SDK を追加し、最初のコンパイル/リンクエラーを確認 |
Windows SDK が見つからない/windows.h、rc.exe、kernel32.lib がない |
Visual Studio Installer で Windows SDK を追加 |
does not support platform specification(Ninja / NMake など) |
自動ビルドは -A x64 を渡すため Visual Studio ジェネレーターを使用。CMAKE_GENERATOR の設定を確認 |
| generator / platform が以前のものと一致しない | ツール変更前の native/.../build を別名へ退避して再構成。ホストの sr_fft、sr_gpu、使用時の sr_rx888 と、統合リポジトリの SRdeckPlugin.AribT98/Native/build が対象 |
VS の変更や Ninja からの切り替え後は、環境変数だけを変更しても既存キャッシュは更新されません。
原因の調査には、後続の MSB3073 と終了コードだけでなく、その前にある最初の CMake Error、
実行したコマンド、cmake --version の結果を使います。
git clone https://github.com/sake846/SRdeck.git
cd SRdeck
dotnet restore SRdeck.sln作業前にgit statusでブランチとローカル変更を確認します。ホスト、プラットフォームライブラリ、プラグインを別リリースから混ぜないでください。
dotnet build SRdeck.sln -c ReleaseSRdeckのビルド前に次のネイティブ部品もCMakeで構築されます。
-
SRdeck/native/sr_fft: CPU FFT -
SRdeck/native/sr_gpu: GPU FFTとGPU描画 -
SRdeck/native/sr_rx888:EnableRx888=trueの場合のみ
開発用統合リポジトリでは、さらに AribT98 の CODEC を CMake、AribT61 の CODEC を Cargo で
ビルドします。公開 SRdeck / SRdeckPlugins スナップショットにはこの2プラグインは含まれません。
失敗した場合は、CMake、MSVC x64ツールセット、Windows SDK、出力された最初のネイティブエラーを確認します。後続のC#エラーだけを直そうとしないでください。
全試験:
dotnet test SRdeck.Tests\SRdeck.Tests.csproj -c Release試験名の一覧:
dotnet test SRdeck.Tests\SRdeck.Tests.csproj -c Release --list-testsSRdeck.TestsはxUnit.net v3を使用し、各回帰試験を独立した子プロセスで実行します。Test Explorerからも個別に選択でき、失敗後も後続項目を実行します。文書へ試験件数を固定せず、dotnet test --list-testsを正本にします。
最小のヘッドレスプラグインはContractsとSDKを参照します。
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
<ItemGroup>
<ProjectReference Include="..\SRdeckPlugin.Contracts\SRdeckPlugin.Contracts.csproj" />
<ProjectReference Include="..\SRdeckPlugin.Sdk\SRdeckPlugin.Sdk.csproj" />
</ItemGroup>
</Project>必要な場合だけ追加します。
- UI:
SRdeckPlugin.Wpf、TargetFrameworkをnet10.0-windows、UseWPF=true - 共通DSP:
SRdeckCore.SignalProcessing - ネイティブ部品: x64配置、ライセンス、ロード失敗時処理
公式スターター:
-
docs/samples/SRdeckPlugin.Example: 生IQのヘッドレス例 -
docs/samples/SRdeckPlugin.ChannelExample: 標準チャネルIQの例
対象ホストと同じGitHub Releaseから次のNuGetパッケージを取得します。
SRdeckPlugin.ContractsSRdeckPlugin.SdkSRdeckPlugin.WpfSRdeckCore.SignalProcessing
4パッケージを同じ版に揃え、ローカルフィードへ置きます。公開フィードの無条件な最新版を参照せず、SRdeckPlatformVersionを対象ホスト版へ固定します。
<PropertyGroup>
<SRdeckPlatformVersion>0.1.0</SRdeckPlatformVersion>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="SRdeckPlugin.Contracts"
Version="$(SRdeckPlatformVersion)" />
<PackageReference Include="SRdeckPlugin.Sdk"
Version="$(SRdeckPlatformVersion)" />
</ItemGroup>実際の版は対象Releaseに合わせてください。復元時はローカルフィードに加え、パッケージの一般依存を取得するために組織で許可されたNuGetソースを設定します。
dotnet build docs\samples\SRdeckPlugin.Example\SRdeckPlugin.Example.csproj -c Release
dotnet run --project docs\samples\SRdeckPlugin.Example.Tests\SRdeckPlugin.Example.Tests.csproj -c Releaseチャネル例も同様にビルドとテストを実行します。新規プロジェクトを始める前にサンプルが通ることを確認すると、SDK環境と自作コードの問題を分離できます。
プラグインDLLは、実際に起動するSRdeck.exeと同じフォルダーへ置きます。pluginsサブフォルダーではありません。
<debug-host>\
├── SRdeck.exe
├── SRdeckPlugin.MyDecoder.dll
└── MyDecoder.NativeDependency.dll
推奨手順:
- クリーンなホストフォルダーを用意します。
- ビルド後イベントまたは手動コピーで対象プラグインだけを配置します。
- SRdeckを再起動します。
- MODE、Initialize、Activate、Start、Stopをログとデバッガーで確認します。
- DLLがロックされるため、再ビルド前にSRdeckを終了します。
ホスト本体の出力フォルダーへ多数の開発版を混在させると、依存競合の原因が分かりにくくなります。
-
dotnet buildで警告とAPI不一致を確認 - プラグイン単体テスト
- ライフサイクル適合テスト
- クリーンなホストでロード
- 既知IQ/実信号でDSP確認
- Start/Stop/MODE切り替え反復
- Release構成と配布フォルダーで再確認
- 全体回帰試験
テストと配布の詳細はテストと配布を参照してください。