SA-MP Plugin Geliştirme Ortamı Nasıl Kurulur?
Bu adımda starter adlı plugin için tekrar üretilebilir bir CMake projesi kuracağız. Amaç IDE’ye özel ayar ezberlemek değil; aynı kaynak koddan Windows için starter.dll, Linux için starter.so üretebilen temiz bir temel hazırlamak.
Gerekli araçlar
Bölüm başlığı “Gerekli araçlar”Windows
Bölüm başlığı “Windows”- C++ masaüstü geliştirme bileşenleri kurulmuş Visual Studio,
- CMake 3.20 veya üzeri,
- klasik SA-MP ile uyumlu plugin SDK,
- test için ayrı bir SA-MP sunucu klasörü.
Visual Studio kurulumunda MSVC, Windows SDK ve CMake tools for Windows bileşenlerini seç. Klasik Windows sunucusu için proje üretirken Win32 hedefini kullanacağız.
- C++17 destekleyen GCC veya Clang,
- CMake 3.20 veya üzeri,
- 32 bit çıktı üretmek için multilib geliştirme paketleri,
- klasik SA-MP ile uyumlu plugin SDK.
Dağıtım yapacağın Linux sürümüne yakın bir ortamda Release derlemesi almak, çalışma zamanı kütüphanesi uyuşmazlıklarını azaltır.
SA-MP plugin SDK ne sağlar?
Bölüm başlığı “SA-MP plugin SDK ne sağlar?”SDK’nin bu rehberde kullandığımız iki ana başlığı vardır:
SDK/amx/amx.h:AMX,cellve AMX API fonksiyonlarını tanımlar.SDK/plugincommon.h: plugin export makrolarını, destek bayraklarını ve sunucunun verdiği fonksiyon tablosunu tanımlar.
SDK klasörünün içeriğini rastgele eksiltme. Farklı paketlerde ek başlıklar bulunabilir; kendi paketinin dizin yapısını koru. Rehberdeki include yolları şu proje ağacını varsayar:
starter-plugin/├── CMakeLists.txt├── starter.def├── SDK/│ ├── plugincommon.h│ └── amx/│ ├── amx.h│ └── ...├── pawn/│ └── include/│ └── starter.inc└── src/ └── main.cppbuild/ klasörü kaynak ağacına eklenmeyecek; CMake tarafından daha sonra oluşturulacak.
CMake projesini oluştur
Bölüm başlığı “CMake projesini oluştur”Kök dizindeki CMakeLists.txt dosyasına şunu ekle:
cmake_minimum_required(VERSION 3.20)
project(starter VERSION 1.0.0 LANGUAGES CXX)
add_library(starter SHARED src/main.cpp)
target_include_directories(starter PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}")
target_compile_features(starter PRIVATE cxx_std_17)
set_target_properties(starter PROPERTIES PREFIX "" OUTPUT_NAME "starter")
if(WIN32) target_sources(starter PRIVATE starter.def)
if(MSVC) target_compile_options(starter PRIVATE /W4 /EHsc) endif()else() target_compile_options(starter PRIVATE -m32 -Wall -Wextra -Wpedantic ) target_link_options(starter PRIVATE -m32)endif()Buradaki üç karar önemlidir:
SHARED, çalıştırılabilir dosya değil dinamik kütüphane üretir.PREFIX "", Linux’ta varsayılanlibstarter.soyerinestarter.soadını kullanır.- uyarı seviyeleri, bellek ve tür hatalarını daha sunucuya yüklemeden yakalamaya yardım eder.
Windows export dosyasını hazırla
Bölüm başlığı “Windows export dosyasını hazırla”starter.def, sunucunun DLL içinde bulacağı giriş noktalarını listeler:
EXPORTS Supports Load Unload AmxLoad AmxUnloadİleride ProcessTick veya sampgdk callback’i eklediğimizde bu listeyi de güncelleyeceğiz. Kaynak kodda fonksiyonun bulunması tek başına yeterli değildir; Windows DLL export tablosunda görünmesi gerekir.
Klasörleri neden ayırıyoruz?
Bölüm başlığı “Klasörleri neden ayırıyoruz?”src/: yalnızca C++ uygulama kodu,SDK/: SA-MP ile konuşmak için gereken uyumluluk katmanı,pawn/include/: gamemode geliştiricisinin kullanacağı public Pawn API,build/: geçici derleme dosyaları ve çıktı.
Bu ayrım, daha sonra SDK’yı veya derleme sistemini değiştirirken Pawn API sözleşmesini bozmadan ilerlemeni sağlar.
İlk kontrol noktası
Bölüm başlığı “İlk kontrol noktası”Şu aşamada aşağıdakiler hazır olmalı:
- C++ derleyicisi ve CMake terminalden çalışıyor,
- SDK başlıkları proje içinde doğru konumda,
- Windows hedefi
Win32, Linux hedefi 32 bit olarak planlandı, .defdosyasında beş temel giriş noktası bulunuyor.
Henüz configure veya build çalıştırma; src/main.cpp dosyasını bir sonraki adımda eksiksiz oluşturacağız.
Sıradaki adım: İlk SA-MP C++ pluginini yaz ve yükle.