コンテンツにスキップ

Windows で Siv3D プログラミングを始める

1. システム要件

1.1 開発者システム要件

Windows で Siv3D プログラミングをするのに必要な開発環境は次のとおりです。
OS Windows 10 (64-bit) / Windows 11
CPU Intel または AMD 製の CPU
映像出力 モニタなど、何らかの映像出力装置があること
音声出力 何らかの音声出力装置があること
開発環境 Microsoft Visual C++ 2022 17.5
(インストーラ内で「C++ によるデスクトップ開発」を追加インストールしてください)
Visual Studio のエディションについて

Windows 10, Windows 11 のパソコンで Siv3D プログラミングをする場合は「Visual Studio Community 2022（ビジュアル・スタジオ・コミュニティ 2022）」を使うのが便利です。これは世界中のプロフェッショナルのソフトウェア開発者が使う「Visual Studio」という統合開発環境の無料版です。学生、個人、少規模の開発であれば、Visual Studio の有料版と同じ機能を無料で使えます。

Visual Studio のインストールについて

Visual Studio ダウンロードページ から「Visual Studio 2022 コミュニティ」のインストーラをダウンロードし実行します。

インストーラを実行すると、プログラミング言語や開発ツールを選択する、次のような画面が出てきます。この中から「C++ によるデスクトップ開発」を選択します（右側の「インストールの詳細」に表示される項目は Visual Studio のバージョンによって異なるため、気にする必要はありません）。

そのまま右下の 「インストール」 ボタンを押せば、C++ プログラミングに必要なツールのインストールが始まります。

1.2 アプリ動作システム要件

Windows で Siv3D v0.6.12 を使って開発されたアプリケーションを実行するのに必要な環境は次のとおりです。ゲームやアプリを配布するときの説明書に記載すると良いでしょう。
OS Windows 7 SP1 (64-bit) / Windows 8.1 (64-bit) / Windows 10 (64-bit) / Windows 11
CPU Intel または AMD 製の CPU
映像出力 モニタなど、何らかの映像出力装置があること
音声出力 何らかの音声出力装置があること

2. SDK をインストールする

  1. OpenSiv3D v0.6.12 Installer for Windows Desktop をダウンロードして実行します。
  2. 実行時に「Windows によって PC が保護されました」と表示された場合は、詳細情報を押して実行を押します。

インストール後に Windows の再起動を推奨

インストーラによって設定された環境変数を Visual Studio に確実に反映させるため、インストール後に Windows を再起動することを推奨します。

どうしても失敗する場合は

インストーラの実行に失敗する場合は、このページの「(補足) SDK を手動インストールする」の方法で SDK をインストールしてください。

インストーラが自動的に行うこと
  • SDK の配置（デフォルトではドキュメントフォルダ）
  • SDK を配置したパスへのユーザ環境変数の設定
  • Siv3D プロジェクト用の Visual Studio プロジェクトテンプレートのコピー (通常は ドキュメント/Visual Studio 2022/Templates/ProjectTemplates/)
  • アンインストーラの登録
インストールした OpenSiv3D SDK を削除するには

OpenSiv3D SDK は、通常のアプリケーションと同様、Windows の「設定」からアンインストールします。

過去のバージョン

過去のバージョンの利用は非推奨です。必要な場合に限り、下記からダウンロードしてください。
コンパイラの更新等により、最新の開発環境では過去のバージョンを利用できないことがあります。古い Siv3D プロジェクトをビルドしたい場合は、そのソースコードを最新版のプロジェクトへ移植するのが良い方法です。

3. Siv3D プロジェクトを作成する

  1. Visual Studio のスタート画面で 新しいプロジェクトの作成 をクリックします。
  2. プロジェクト テンプレートの項目から OpenSiv3D を選択し、次へ を押します。
  3. プロジェクト名と保存場所を入力し（任意）、作成 を押します。

4. Siv3D アプリをビルドする

  1. プロジェクトを作成すると、サンプルプログラム (Main.cpp) が最初から用意されています。
  2. ビルド メニューからプロジェクトをビルドします。
  3. デバッグ メニューの デバッグの開始 を押すと、ビルドしたプログラムが実行されます。
  4. 実行中のプログラムは、Esc を押すか、ウィンドウを閉じると終了します。
「Siv3D.hpp が見つからない」エラーが出る場合

インストーラによって設定された Siv3D SDK のインストール先の情報が、Visual Studio に反映されていないのが原因です。Windows を再起動し、再度新しい Siv3D プロジェクトを作成すると解決します。

（補足）SDK を手動インストールする

OpenSiv3D インストーラが正常に実行されない場合、代わりに手作業で OpenSiv3D をインストールできます。手順は次のとおりです。

SDK を手動インストールする場合の手順

SDK ファイルの配置と環境変数の設定

  1. OpenSiv3D_SDK_0.6.12.zip をダウンロードして展開し、中身をドキュメントフォルダ（.../Documents）に次のように配置します。
    • .../Documents/OpenSiv3D_SDK_0.6.12/addon
    • .../Documents/OpenSiv3D_SDK_0.6.12/include
    • .../Documents/OpenSiv3D_SDK_0.6.12/lib
  2. ユーザー環境変数 SIV3D_0_6_12 を新規作成し、1. で配置した OpenSiv3D SDK のフォルダのパスを設定します。
    • 例: C:/Users/Siv3D/Documents/OpenSiv3D_SDK_0.6.12/include のように配置した場合、C:/Users/Siv3D/Documents/OpenSiv3D_SDK_0.6.12 を環境変数 SIV3D_0_6_12 に設定します。

Visual Studio プロジェクトテンプレートの配置

  1. Visual Studio 用プロジェクトテンプレート OpenSiv3D_0.6.12.zip (サイズ: 約 63 MB) をダウンロードし、そのファイルを展開せず ZIP ファイルのまま、Visual Studio 2022 インストール時にドキュメントフォルダに作成される Visual Studio 2022/Templates/ProjectTemplates/ フォルダの中に配置します。

以上で手動インストールの手順は完了です。環境変数の適用を確実にするために PC を再起動したのち、本ページの 3. の手順に進んでください。