upd: vcpkg for macOS

Author: guinpen98

Projects/MapViewer/CMakeLists.txt

@@ -37,20 +37,11 @@ if(NOT SFML_FOUND)
     # First try to find SFML via vcpkg (standard CMake config)
     find_package(SFML 3 QUIET COMPONENTS Graphics Window System)
 
-    # If not found via vcpkg, try project-local SFML
+    # If not found via vcpkg, try custom finder (includes project-local SFML for Windows and legacy macOS)
     if(NOT SFML_FOUND)
-        # Set SFML_ROOT_DIR for project-local SFML installation
-        if(NOT SFML_ROOT_DIR)
-            set(SFML_LOCAL_PATH "${CMAKE_CURRENT_SOURCE_DIR}/${OS}/SFML_3.0.0")
-            if(EXISTS "${SFML_LOCAL_PATH}")
-                set(SFML_ROOT_DIR "${SFML_LOCAL_PATH}")
-                message(STATUS "Using project-local SFML: ${SFML_ROOT_DIR}")
-            endif()
-        endif()
-
         find_package(SFMLCustom QUIET)
     else()
-        message(STATUS "Found SFML ${SFML_VERSION} via CMake config")
+        message(STATUS "Found SFML ${SFML_VERSION} via CMake config (vcpkg or system)")
     endif()
 endif()
 
@@ -65,8 +56,10 @@ if(WIN32)
     add_executable(${BINARY_NAME} ${CPP_FILE})
     paxs_setup_sfml(${BINARY_NAME})
     paxs_copy_config_tsv(${BINARY_NAME} ${TSV_SOURCE_PATH})
-elseif(APPLE)
-    set(CPP_FILE "${CMAKE_CURRENT_SOURCE_DIR}/${OS}/SFML_3.0.0/Main.cpp")
+elseif(APPLE AND SFML_FOUND)
+    if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/${OS}/SFML/Main.cpp")
+        set(CPP_FILE "${CMAKE_CURRENT_SOURCE_DIR}/${OS}/SFML/Main.cpp")
+    endif()
 
     if(PAXS_BUILD_TYPE STREQUAL "Production")
         # Production: macOS .app bundle
@@ -88,51 +81,48 @@ elseif(APPLE)
 
         target_link_libraries(${BINARY_NAME} PRIVATE SFML::Graphics curl)
 
-        # Copy SFML frameworks to the bundle
-        if(SFML_FOUND)
-            # Get SFML library paths
-            get_target_property(SFML_GRAPHICS_LIB SFML::Graphics IMPORTED_LOCATION_RELEASE)
-            if(NOT SFML_GRAPHICS_LIB)
-                get_target_property(SFML_GRAPHICS_LIB SFML::Graphics IMPORTED_LOCATION)
-            endif()
-
-            if(SFML_GRAPHICS_LIB)
-                get_filename_component(SFML_LIB_DIR ${SFML_GRAPHICS_LIB} DIRECTORY)
-                set(APP_FRAMEWORKS_DIR "$<TARGET_BUNDLE_CONTENT_DIR:${BINARY_NAME}>/Frameworks")
-
-                add_custom_command(
-                    TARGET ${BINARY_NAME} POST_BUILD
-                    # MacOS/にProdConfig.tsvをコピー
-                    COMMAND ${CMAKE_COMMAND} -E copy_if_different
-                        "${CMAKE_CURRENT_SOURCE_DIR}/${OS}/ProdConfig.tsv"
-                        "$<TARGET_FILE_DIR:${BINARY_NAME}>/Config.tsv"
-
-                    # Resources/にappicon.icnsをコピー
-                    COMMAND ${CMAKE_COMMAND} -E make_directory
-                        "$<TARGET_BUNDLE_CONTENT_DIR:${BINARY_NAME}>/Resources"
-                    COMMAND ${CMAKE_COMMAND} -E copy_if_different
-                        "${CMAKE_CURRENT_SOURCE_DIR}/${OS}/appicon.icns"
-                        "$<TARGET_BUNDLE_CONTENT_DIR:${BINARY_NAME}>/Resources/appicon.icns"
-
-                    # SFML の dylib をコピーして install_name_tool でパスを修正
-                    COMMAND ${CMAKE_COMMAND} -E make_directory
-                        ${APP_FRAMEWORKS_DIR}
-                    COMMAND ${CMAKE_COMMAND} -E copy_if_different
-                        ${SFML_LIB_DIR}/libsfml-graphics.3.0.dylib
-                        ${APP_FRAMEWORKS_DIR}/
-                    COMMAND ${CMAKE_COMMAND} -E copy_if_different
-                        ${SFML_LIB_DIR}/libsfml-window.3.0.dylib
-                        ${APP_FRAMEWORKS_DIR}/
-                    COMMAND ${CMAKE_COMMAND} -E copy_if_different
-                        ${SFML_LIB_DIR}/libsfml-system.3.0.dylib
-                        ${APP_FRAMEWORKS_DIR}/
-
-                    COMMAND install_name_tool -change ${SFML_LIB_DIR}/libsfml-graphics.3.0.dylib @rpath/libsfml-graphics.3.0.dylib $<TARGET_FILE:${BINARY_NAME}>
-                    COMMAND install_name_tool -change ${SFML_LIB_DIR}/libsfml-window.3.0.dylib   @rpath/libsfml-window.3.0.dylib   $<TARGET_FILE:${BINARY_NAME}>
-                    COMMAND install_name_tool -change ${SFML_LIB_DIR}/libsfml-system.3.0.dylib   @rpath/libsfml-system.3.0.dylib   $<TARGET_FILE:${BINARY_NAME}>
-                    COMMENT "Copying SFML dylibs to app bundle and fixing install names..."
-                )
-            endif()
+        # Get SFML library paths
+        get_target_property(SFML_GRAPHICS_LIB SFML::Graphics IMPORTED_LOCATION_RELEASE)
+        if(NOT SFML_GRAPHICS_LIB)
+            get_target_property(SFML_GRAPHICS_LIB SFML::Graphics IMPORTED_LOCATION)
+        endif()
+
+        if(SFML_GRAPHICS_LIB)
+            get_filename_component(SFML_LIB_DIR ${SFML_GRAPHICS_LIB} DIRECTORY)
+            set(APP_FRAMEWORKS_DIR "$<TARGET_BUNDLE_CONTENT_DIR:${BINARY_NAME}>/Frameworks")
+
+            add_custom_command(
+                TARGET ${BINARY_NAME} POST_BUILD
+                # MacOS/にProdConfig.tsvをコピー
+                COMMAND ${CMAKE_COMMAND} -E copy_if_different
+                    "${CMAKE_CURRENT_SOURCE_DIR}/${OS}/ProdConfig.tsv"
+                    "$<TARGET_FILE_DIR:${BINARY_NAME}>/Config.tsv"
+
+                # Resources/にappicon.icnsをコピー
+                COMMAND ${CMAKE_COMMAND} -E make_directory
+                    "$<TARGET_BUNDLE_CONTENT_DIR:${BINARY_NAME}>/Resources"
+                COMMAND ${CMAKE_COMMAND} -E copy_if_different
+                    "${CMAKE_CURRENT_SOURCE_DIR}/${OS}/appicon.icns"
+                    "$<TARGET_BUNDLE_CONTENT_DIR:${BINARY_NAME}>/Resources/appicon.icns"
+
+                # SFML の dylib をコピーして install_name_tool でパスを修正
+                COMMAND ${CMAKE_COMMAND} -E make_directory
+                    ${APP_FRAMEWORKS_DIR}
+                COMMAND ${CMAKE_COMMAND} -E copy_if_different
+                    ${SFML_LIB_DIR}/libsfml-graphics.3.0.dylib
+                    ${APP_FRAMEWORKS_DIR}/
+                COMMAND ${CMAKE_COMMAND} -E copy_if_different
+                    ${SFML_LIB_DIR}/libsfml-window.3.0.dylib
+                    ${APP_FRAMEWORKS_DIR}/
+                COMMAND ${CMAKE_COMMAND} -E copy_if_different
+                    ${SFML_LIB_DIR}/libsfml-system.3.0.dylib
+                    ${APP_FRAMEWORKS_DIR}/
+
+                COMMAND install_name_tool -change ${SFML_LIB_DIR}/libsfml-graphics.3.0.dylib @rpath/libsfml-graphics.3.0.dylib $<TARGET_FILE:${BINARY_NAME}>
+                COMMAND install_name_tool -change ${SFML_LIB_DIR}/libsfml-window.3.0.dylib   @rpath/libsfml-window.3.0.dylib   $<TARGET_FILE:${BINARY_NAME}>
+                COMMAND install_name_tool -change ${SFML_LIB_DIR}/libsfml-system.3.0.dylib   @rpath/libsfml-system.3.0.dylib   $<TARGET_FILE:${BINARY_NAME}>
+                COMMENT "Copying SFML dylibs to app bundle and fixing install names..."
+            )
         endif()
     else()
         # Development: standard executable

Projects/MapViewer/Linux/SFML/README.md

@@ -1,10 +1,10 @@
-# SFML 3.0.0 MapViewer for Linux (Ubuntu)
+# SFML MapViewer for Linux (Ubuntu)
 
 ## 概要 (Overview)
 
-このディレクトリには、Linux（Ubuntu）環境でSFML 3.0.0を使用してMapViewerをビルドするためのファイルが含まれています。
+このディレクトリには、Linux（Ubuntu）環境でSFMLを使用してMapViewerをビルドするためのファイルが含まれています。
 
-This directory contains files for building MapViewer with SFML 3.0.0 on Linux (Ubuntu).
+This directory contains files for building MapViewer with SFML on Linux (Ubuntu).
 
 ## 必要な環境 (Requirements)
 
@@ -29,33 +29,37 @@ cd /path/to/PAX_SAPIENTICA
 このスクリプトは以下を自動的に実行します：
 - 必要なシステムパッケージのインストール
 - vcpkgのクローンとブートストラップ
-- SFML 3.0.0のインストール
+- SFMLのインストール
 
 This script will automatically:
 - Install required system packages
 - Clone and bootstrap vcpkg
-- Install SFML 3.0.0
+- Install SFML
 
 ### ステップ2: プロジェクトのビルド (Step 2: Build the project)
 
 ```bash
-mkdir -p Projects/build
-cd Projects/build
-cmake .. -DCMAKE_TOOLCHAIN_FILE=../../vcpkg/scripts/buildsystems/vcpkg.cmake
-cmake --build .
+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)
 
 ```bash
-./MapViewer/SFMLMapViewer
+./build/MapViewer/SFMLMapViewer
 ```
 
 ## vcpkgを使用しない場合 (Without vcpkg)
 
-vcpkgを使用せずにSFML 3.0.0をソースからビルドする場合：
+vcpkgを使用せずにSFMLをソースからビルドする場合：
 
-If you want to build SFML 3.0.0 from source without vcpkg:
+If you want to build SFML from source without vcpkg:
 
 ### 依存関係のインストール (Install dependencies)
 
@@ -77,7 +81,7 @@ sudo apt install -y \
     libgbm-dev
 ```
 
-### SFML 3.0.0のビルドとインストール (Build and install SFML 3.0.0)
+### SFML のビルドとインストール (Build and install SFML)
 
 ```bash
 # SFML 3.0.0をクローン

…ects/MapViewer/macOS/SFML_3.0.0/Main.cpp Projects/MapViewer/macOS/SFML/Main.cppProjects/MapViewer/macOS/SFML_3.0.0/Main.cpp renamed to Projects/MapViewer/macOS/SFML/Main.cpp Projects/MapViewer/macOS/SFML_3.0.0/Main.cpp renamed to Projects/MapViewer/macOS/SFML/Main.cpp

@@ -12,8 +12,6 @@
 #define _CRT_SECURE_NO_WARNINGS
 #define PAXS_USING_SFML
 
-// STB implementation must be defined in exactly one cpp file per executable
-#define STB_IMAGE_WRITE_IMPLEMENTATION
 #include <stb/stb_image_write.h>
 
 #include <SFML/Graphics.hpp>

Projects/MapViewer/macOS/SFML/README.md

@@ -0,0 +1,137 @@
+# SFML MapViewer for macOS
+
+## 概要 (Overview)
+
+このディレクトリには、macOS環境でSFMLを使用してMapViewerをビルドするためのファイルが含まれています。
+
+This directory contains files for building MapViewer with SFML on macOS.
+
+## 必要な環境 (Requirements)
+
+- macOS 11.0 (Big Sur) 以降 (macOS 11.0 or later)
+- Homebrew
+- 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:
+
+```bash
+cd /path/to/PAX_SAPIENTICA
+./Scripts/SetupVcpkgMac.sh
+```
+
+このスクリプトは以下を自動的に実行します：
+- Homebrewを使用した必要なシステムパッケージのインストール
+- vcpkgのクローンとブートストラップ
+- SFMLのインストール
+
+This script will automatically:
+- Install required system packages using Homebrew
+- Clone and bootstrap vcpkg
+- Install SFML
+
+### ステップ2: プロジェクトのビルド (Step 2: Build the project)
+
+```bash
+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）
+
+### ステップ3: 実行 (Step 3: Run)
+
+```bash
+./build/MapViewer/SFMLMapViewer
+```
+
+## vcpkgを使用しない場合 (Without vcpkg)
+
+vcpkgを使用せずにSFMLをソースからビルドする場合：
+
+If you want to build SFML from source without vcpkg:
+
+### 依存関係のインストール (Install dependencies)
+
+```bash
+brew install cmake ninja pkg-config
+```
+
+### SFMLのビルドとインストール (Build and install SFML)
+
+```bash
+# 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)
+
+```bash
+cd /path/to/PAX_SAPIENTICA/Projects
+mkdir -p build && cd build
+cmake ..
+cmake --build .
+```
+
+## Apple Siliconについて (About Apple Silicon)
+
+Apple Siliconを使用している場合、vcpkgは自動的に `arm64-osx` トリプレットを使用します。Intel Macの場合は `x64-osx` が使用されます。
+
+When using Apple Silicon, vcpkg will automatically use the `arm64-osx` triplet. For Intel Macs, `x64-osx` will be used.
+
+## トラブルシューティング (Troubleshooting)
+
+### SFML が見つからない (SFML not found)
+
+CMake実行時に以下のようなメッセージが表示される場合：
+
+```
+SFML not found - MapViewer will not be built
+```
+
+解決方法：
+1. vcpkgのセットアップスクリプトが正常に完了したか確認
+2. CMake実行時に `-DCMAKE_TOOLCHAIN_FILE` オプションを指定しているか確認
+3. vcpkgディレクトリが正しい場所に存在するか確認
+
+### Homebrewがインストールされていない (Homebrew not installed)
+
+Homebrewがインストールされていない場合、以下のコマンドでインストールしてください：
+
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+### ビルドエラー (Build errors)
+
+Xcodeコマンドラインツールが不足している場合、以下を実行：
+
+```bash
+xcode-select --install
+```
+
+## 参考リンク (References)
+
+- [SFML 3.0 公式ドキュメント](https://www.sfml-dev.org/tutorials/3.0/)
+- [vcpkg 公式サイト](https://vcpkg.io/)
+- [Homebrew 公式サイト](https://brew.sh)
+- [PAX_SAPIENTICA メインREADME](../../../../README.md)