アーキテクチャ

システム概要

ジェネレータアーキテクチャ

generate.ts - エントリーポイント

ジェネレータのメインファイルです。コマンドライン引数を解析し、プロジェクト生成を制御します。

// コマンドライン引数の解析
const args = parseArgs(Deno.args, {
  boolean: ["help", "with-git"],
  string: ["name", "author", "version", "output"],
  default: {
    name: "MyApp",
    author: "Your Name",
    version: "1.0.0",
  },
});

// プロジェクト設定の構築
const config: ProjectConfig = {
  name: projectName,
  nameLower: toSnakeCase(projectName),
  nameUpper: nameLower.toUpperCase(),
  author: args.author,
  version: args.version,
  outputDir: args.output || projectName.toLowerCase(),
  withGit: args["with-git"],
};

templates.ts - テンプレート生成

各ファイルのテンプレートを生成する関数群です。プロジェクト設定に基づいて動的にコンテンツを生成します。

// CMakeLists.txt の生成例
export function generateCMakeLists(config: ProjectConfig): string {
  return `cmake_minimum_required(VERSION 3.15)
project(${config.name} VERSION ${config.version} LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
...
`;
}

Deno URL実行の仕組み

Denoは deno run <url> でリモートのTypeScriptを直接実行できます。 これにより、ユーザーはツールをインストールせずにジェネレータを使用できます。

ビルドシステムアーキテクチャ

build.ts - ビルドスクリプト

Denoとdaxを使用したクロスプラットフォームビルドスクリプトです。

import $ from "jsr:@david/dax@0.42.0";

// CMake設定
async function configure(): Promise<void> {
  await $`mkdir -p build`;
  await setupFileAPI("build");
  await $`cmake -B build -DCMAKE_BUILD_TYPE=${args.config}`;
}

// ビルド実行
async function build(): Promise<BuildArtifact[]> {
  await $`cmake --build build --config ${args.config}`;
  const artifacts = await parseFileAPI("build");
  return artifacts;
}

dax の特徴

• クロスプラットフォーム - $`mkdir -p` がWindowsでも動作
• テンプレートリテラル - 変数の安全な埋め込み
• エラーハンドリング - コマンド失敗時の自動例外スロー
• パイプ・リダイレクト - シェルライクな操作が可能

CMake File API連携

CMake File API v1 を使用して、ビルド成果物の情報をプログラマティックに取得します。 これにより、ハードコードされたパスに依存せず、プラットフォームやジェネレータに応じた 正しいパスを自動検出できます。

仕組み

Reply構造

// cmake-types.ts より
interface FileAPIIndex {
  cmake: { version: {...} };
  objects: Array<{ kind: string; jsonFile: string; }>;
  reply: {
    [key: string]: { kind: string; jsonFile: string; };
  };
}

interface CodeModelV2 {
  paths: { source: string; build: string; };
  configurations: Array<{
    name: string;
    targets: Array<{ name: string; jsonFile: string; }>;
  }>;
}

interface TargetInfo {
  name: string;
  type: "EXECUTABLE" | "STATIC_LIBRARY" | "SHARED_LIBRARY";
  artifacts?: Array<{ path: string; }>;
}

利点

• Visual Studio / Unix Makefiles / Ninja など、どのジェネレータでも動作
• Debug / Release などのビルドタイプを自動認識
• 生成されたすべてのターゲット（実行ファイル、ライブラリ）を自動検出

C++プロジェクト構造

ターゲット構成

add_library(myapp_core STATIC
    src/core/core.cpp
    src/core/core.h
)

add_library(myapp_utils SHARED
    src/utils/utils.cpp
    src/utils/utils.h
)
target_compile_definitions(myapp_utils
    PRIVATE MYAPP_UTILS_EXPORTS)

add_executable(myapp src/main.cpp)
target_link_libraries(myapp PRIVATE
    myapp_core
    myapp_utils
)

Windows DLLエクスポート

Windows環境では、共有ライブラリのシンボルを適切にエクスポート/インポートする必要があります：

// utils.h
#ifdef _WIN32
    #ifdef MYAPP_UTILS_EXPORTS
        #define MYAPP_UTILS_API __declspec(dllexport)
    #else
        #define MYAPP_UTILS_API __declspec(dllimport)
    #endif
#else
    #define MYAPP_UTILS_API
#endif

MYAPP_UTILS_API void myFunction();

依存関係

すべての依存関係は JSR (JavaScript Registry) から取得されます。 Denoは実行時に自動的にダウンロード・キャッシュします。

セキュリティモデル

Denoはデフォルトでセキュアです。ジェネレータは必要最小限の権限のみを要求します：