SFML MapViewer for Linux (Ubuntu)

November 30, 2025 · View on GitHub

概要 (Overview)

このディレクトリには、Linux（Ubuntu）環境でSFMLを使用してMapViewerをビルドするためのファイルが含まれています。

This directory contains files for building MapViewer with SFML on Linux (Ubuntu).

必要な環境 (Requirements)

  • Ubuntu 20.04 以降 (Ubuntu 20.04 or later)
  • CMake 3.16 以降 (CMake 3.16 or later)
  • C++20 対応コンパイラ (C++20 compatible compiler)
  • Git

インストール手順 (Installation)

ステップ1: vcpkgのセットアップ (Step 1: Setup vcpkg)

プロジェクトルートディレクトリから、vcpkgセットアップスクリプトを実行します：

From the project root directory, run the vcpkg setup script:

cd /path/to/PAX_SAPIENTICA
./Scripts/SetupVcpkgLinux.sh

このスクリプトは以下を自動的に実行します：

  • 必要なシステムパッケージのインストール
  • vcpkgのクローンとブートストラップ
  • SFMLのインストール

This script will automatically:

  • Install required system packages
  • Clone and bootstrap vcpkg
  • Install SFML

ステップ2: プロジェクトのビルド (Step 2: Build the project)

cd /path/to/PAX_SAPIENTICA
cmake -B build -S Projects -DCMAKE_TOOLCHAIN_FILE=vcpkg/scripts/buildsystems/vcpkg.cmake -DSFML_STATIC_LIBRARIES=TRUE -DVCPKG_INSTALLED_DIR=vcpkg_installed
cmake --build build

重要なオプション (Important options):

  • -DSFML_STATIC_LIBRARIES=TRUE: vcpkg版SFMLのスタティックライブラリを使用（必須 / required）
  • -DVCPKG_INSTALLED_DIR=vcpkg_installed: vcpkgのインストール先をプロジェクトルートに指定（推奨 / recommended）
  • -B build -S Projects: ビルドディレクトリをプロジェクトルートに作成（Build directory at project root）

ステップ3: 実行 (Step 3: Run)

./build/MapViewer/SFMLMapViewer

vcpkgを使用しない場合 (Without vcpkg)

vcpkgを使用せずにSFMLをソースからビルドする場合：

If you want to build SFML from source without vcpkg:

依存関係のインストール (Install dependencies)

sudo apt update
sudo apt install -y \
    cmake \
    ninja-build \
    libxrandr-dev \
    libxcursor-dev \
    libxi-dev \
    libudev-dev \
    libfreetype-dev \
    libflac-dev \
    libvorbis-dev \
    libgl1-mesa-dev \
    libegl1-mesa-dev \
    libdrm-dev \
    libgbm-dev

SFML のビルドとインストール (Build and install SFML)

# SFML 3.0.0をクローン
git clone https://github.com/SFML/SFML.git
cd SFML
git checkout 3.0.0

# ビルド
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .

# インストール
sudo cmake --install .

プロジェクトのビルド (Build the project)

cd /path/to/PAX_SAPIENTICA/Projects
mkdir -p build && cd build
cmake ..
cmake --build .

トラブルシューティング (Troubleshooting)

SFML が見つからない (SFML not found)

CMake実行時に以下のようなメッセージが表示される場合：

SFML not found - MapViewer will not be built

解決方法：

  1. vcpkgのセットアップスクリプトが正常に完了したか確認
  2. CMake実行時に -DCMAKE_TOOLCHAIN_FILE オプションを指定しているか確認
  3. vcpkgディレクトリが正しい場所に存在するか確認

ビルドエラー (Build errors)

システムの依存関係が不足している場合、以下を実行：

sudo apt update
sudo apt install -y build-essential cmake pkg-config

参考リンク (References)