THE OPERATIVE · NO ONE LIVES FOREVER · PORT

2. téma: macOS

Az Xcode projekt, a Metal renderelő és a SwiftUI indító: így lesz NOLF1.app
TOPIC 2 · MACOS

Az eredeti port Macre készült (Apple Silicon, „no emulation, no Wine, no virtual machine”). Itt nincs build-szkript: az egészet a NOLF1.xcodeproj írja le, és az Xcode (vagy parancssorból az xcodebuild) fordítja. A végeredmény egy közönséges NOLF1.app, benne a játékmotorral és a szerver modullal.

NOLF macOS-en
A macOS-port Metal renderelővel (az ablakcímben: 3D 2560×1600, 2D 1280×800, 60 FPS). Forrás: a repó screenshots/ mappája.

Követelmények

Az Xcode projekt: három target

NOLF1LauncherSwiftUI app → NOLF1.app nolf1parancssori exe: motor + ClientShellDLL + Shared nolfobjectlibnolfobject.dylib: ObjectDLL + Shared függ tőlük + „Embed Game” → Contents/Helpers/ dlopen
TargetTípusMit fordítMit NEM (membershipExceptions)
NOLF1Launcherapplication → NOLF1.applauncher/ (Swift + hu.txt erőforrásként), assets/Images.xcassets (ikon)–
nolf1tool (parancssori Mach-O)LT2, engine, NOLF mappák; Cocoa, Metal, QuartzCore, AudioToolbox, CoreFoundation keretrendszerek; -D_CLIENTBUILDaz összes ObjectDLL/*.cpp, ClientRes/main.cpp, NetInfo.cpp, PlayerData.cpp, generated/Animation*.cpp, ltengineobjects.cpp
nolfobjectdynamic library → libnolfobject.dylibNOLF/ObjectDLL + Shared + engine/libs + engine/generated; linkelés: -undefined dynamic_lookupszinte az egész motor és a teljes ClientShellDLL
„Szinkronizált mappa” (Xcode 16+): a projekt nem sorolja fel a fájlokat egyenként, hanem azt mondja: „az engine/ minden fájlja ennek a targetnek a része”, és csak a kivételeket (membershipExceptions) listázza. Ezért kell a Linux-fájlokban az #ifndef __APPLE__: különben a Mac-es build azokat is lefordítaná, és SDL-fejléc hiányában hibával leállna. Pontosan ez történt, a 00a55ff commit javította.

Közös build-beállítások

Ugyanazok, mint Linuxon. Mindkét build ugyanabból az eredeti .dsp konfigurációból indul:

BeállításÉrtékLinuxos megfelelő
CLANG_CXX_LANGUAGE_STANDARDc++17, libc++-std=c++17
GCC_PREPROCESSOR_DEFINITIONSNO_PRAGMA_LIBS _NOLFBUILD _REZFILE _FINAL NDEBUG _LITHTECH_ _LITHTECH2 STRICTDEF=
OTHER_CFLAGS-fdeclspec -Wno-everythingugyanaz
HEADER_SEARCH_PATHSengine/compat, include-shims, LT2/sdk/inc, lithshared/*, engine/*SYS=
USER_HEADER_SEARCH_PATHSNOLF/Shared, ObjectDLL, ClientShellDLL-iquote
GCC_OPTIMIZATION_LEVEL2-O2
CLANG_ENABLE_OBJC_ARCYES (a .mm fájlokhoz)–

Beágyazás és aláírás

NOLF1.xcodeproj/project.pbxproj:45 – „Embed Game”
199D298C53FEF3DAE8A463A8 /* Embed Game */ = {    isa = PBXCopyFilesBuildPhase;  // egy "fájlmásolás" build-lépés    dstPath = Contents/Helpers;  // ide: NOLF1.app/Contents/Helpers/    dstSubfolderSpec = 1;  // 1 = az .app csomag gyökeréhez képest    files = (        1DC49E4B64415120128CDB28 /* nolf1 in Embed Game */,        ↳ a játékmotor        750F0A84DA59D9B196C6B522 /* libnolfobject.dylib in Embed Game */,        ↳ a szerver modul    );  // mindkettő CodeSignOnCopy: másoláskor újraaláírja};

Az eredmény:

NOLF1.app szerkezete
NOLF1.app/  Contents/    MacOS/NOLF1  # a SwiftUI indító    Helpers/nolf1  # a játék (motor + kliens)    Helpers/libnolfobject.dylib    ↳ a szerver modul, ezt dlopen-eli a nolf1    Resources/hu.txt  # a magyar szövegtábla    Resources/Assets.car  # ikon
nolf1.entitlements
<key>com.apple.security.cs.disable-library-validation</key>↳ könyvtár-ellenőrzés kikapcsolása<true/>
MIÉRT kell ez a jogosultság? A nolf1 „hardened runtime” alatt fut. Ilyenkor a macOS csak ugyanazzal a fejlesztői csapat-azonosítóval (Team ID) aláírt dylib-et engedi betölteni. Ad-hoc aláírásnál ez nem teljesül, a dlopen megtagadja a betöltést, és fekete képernyő az eredmény. Ez a kulcs kikapcsolja az ellenőrzést.
Aláírás saját gépen: a projektben DEVELOPMENT_TEAM = EJBTKE7CEJ áll, ez az eredeti szerző csapata. Te kétféleképpen fordíthatsz: (1) Xcode-ban a targeteknél Signing & Capabilities alatt kiválasztod a saját Team-edet vagy a „Sign to Run Locally”-t, a módosított pbxproj-t pedig nem kommitolod; (2) parancssorban ad-hoc aláírással, lásd lent.

A Mac-es motorréteg

FájlMit csinál
engine/platform/ltwindow.mm (836 sor)Cocoa ablak egy LTFrameView : NSView-val (felülről lefelé számoló RGBA). Az egérmozgás deltái az LTInput_Push-ba mennek, a billentyűk az LTInput_MacKeyToVK-n át. Ctrl+Cmd+F: teljes képernyő. A finishLaunching-ot az ablak előtt kell hívni, különben nem jönnek billentyűesemények. A képkockák ütemét egy CADisplayLink adja saját szálon, ProMotion kijelzőn 120 Hz-cel (LT_MAXFPS korlátozza).
engine/render/ltmetal.mm (2729 sor)Metal renderelő CAMetalLayer-rel. A shaderek Metal Shading Language forrásként, C++ raw stringben vannak, és futáskor a newLibraryWithSource: fordítja őket: vs_world fs_world vs_env fs_env vs_skin és a kompozitor vs_full fs_comp vs_far fs_scale. Nincs külön .metal build-lépés.
engine/sound/ltaudio.mm (207 sor)AudioToolbox DefaultOutput AudioUnit, s16 sztereó 44100 Hz; a render callback a közös CLTMixer::Render-t hívja. Az MP3-at az ExtAudioFile bontja ki.
engine/platform/ltsysfont.mm (68 sor)Élsimított betűkép az NSFont boldSystemFontOfSize-ból, NSBitmapImageRep-be rajzolva; az alfa-csatorna lesz a fedettség.
engine/platform/ltsysfont.mm:20 (kivonat) – a FreeType-változat Mac-es ikertestvére
const CGFloat fSize = (CGFloat)nPixelHeight / 1.22;↳ sormagasság ≈ 1,22 × pontméretNSFont* font = [NSFont boldSystemFontOfSize:fSize];↳ a rendszer félkövér betűje (SF Pro)unichar ch = (unichar)cp;NSString* s = [NSString stringWithCharacters:&ch length:1];↳ egyetlen karakterNSDictionary* attrs = @{ NSFontAttributeName: font,                         NSForegroundColorAttributeName: [NSColor whiteColor] };                         ↳ fehér: csak az alfa számítNSSize sz = [s sizeWithAttributes:attrs];int w = (int)ceil(sz.width);w += 1;                                 // a column of air between glyphs↳ +1 oszlop levegő (Linuxon nincs)NSBitmapImageRep* rep = [[NSBitmapImageRep alloc] initWithBitmapDataPlanes:NULL pixelsWide:w pixelsHigh:nPixelHeight ...];↳ 8 bites RGBA kép...[s drawAtPoint:NSMakePoint(0, y) withAttributes:attrs];↳ AppKit rajzol, élsimítással...cov[(size_t)yy * w + xx] = px[yy * stride + xx * 4 + 3];   // alpha↳ csak az alfa-csatornát veszi ki

Képjavítás (csak Mac, Metal)

Az fs_comp shader a 3D jelenetre (a menükre, a HUD-ra és a feliratra nem) három szűrőt tehet:

engine/render/ltmetal.mm:2633
static const float s_fx[3] = {  // egyszer olvassa be, induláskor    getenv("NOLF_SHARPEN") ? (float)atof(getenv("NOLF_SHARPEN")) : 0.0f,    ↳ 0..1, alapból 0 = ki    getenv("NOLF_GRADE")   ? (float)atof(getenv("NOLF_GRADE"))   : 0.0f,    getenv("NOLF_BLOOM")   ? (float)atof(getenv("NOLF_BLOOM"))   : 0.0f };

Közös kód __APPLE__-ágakkal

HelyMacLinux
server/ltserverhost.cpp:57/libnolfobject.dylib/libnolfobject.so
platform/ltbindings.cpp:10, regmgr_impl.cpp:42/Library/Application Support/NOLF1/.local/share/NOLF1
sound/ltdmhost.cpp:33Apple gs_instruments.dlsSF2-keresési lista
render/ltnullrender.cpp:95„Metal - macOS”„OpenGL - Linux”
render/ltnullrender.cpp:232a választott felbontást visszaírja az indító beállításaiba (CFPreferences)–
platform/ltbindings.cpp:1245billentyűnevek a Mac-kiosztásbólUS billentyűnevek

A SwiftUI indító (launcher/)

A NOLF1.app elindításakor nem a játék indul, hanem egy kis SwiftUI ablak: itt választod ki a játék mappáját, a felbontást, a nyelvet, majd megnyomod a Play-t.

FájlFeladat
NOLF1LauncherApp.swift@main. Parancssori módok: --selftest <mappa> (automatikus teszt), --snapshot (képernyőkép az indítóról).
ContentView.swiftA felület. A beállítások @AppStorage-ban maradnak meg. Kapcsolók: „Magyar szöveg és felirat” (alapból be), „Képjavítás” (alapból be, csak Metallal). Haladó beállítások: renderelő, küldetés feloldása, pályanézegető, részletes napló, „Fresh profile”.
GameInstall.swiftMappaellenőrzés: 4 szint mélyen keres *.rez, startup.txt és autoexec.cfg fájlokat; a CD-másolat elrendezését (disc1/Data, disc2/Data, disc2/Game) is felismeri.
GameRunner.swiftÖsszeállítja a környezeti változókat, és Process-ként elindítja a Contents/Helpers/nolf1-et.
Missions.swiftA küldetések és pályák táblázata a haladó menühöz.
SelfTest.swiftAblak nélküli teszt: 400 képkocka, betölt egy pályát, és a naplóban a mounted, [SERVER] loaded és LoadWorld( sorokat keresi.
launcher/GameInstall.swift:123 – mit ellenőriz
if !has("nolf.rez") {  // nincs fő archívum    gi.problems.append("NOLF.REZ, the main game archive, was not found.")}if !has("nolf2.rez") {  // csak az 1. CD-t másoltad át    gi.problems.append("NOLF2.REZ was not found. If you copied the game discs, copy BOTH discs into this folder.")}if autoexec == nil {  // a billentyűk alapértékei kellenek    gi.problems.append("autoexec.cfg was not found -- ...")}if !has("nolfgoty.rez") {↳ CSAK GOTY: a sima kiadás adataival az első pálya előtt összeomlik    gi.problems.append("This is not the Game of the Year edition ...")}if gi.dirs.contains(where: { $0.path.contains(":") }) {↳ a ':' a NOLF_GAME_DIR elválasztója,    gi.problems.append("A folder name contains a colon ...")    ↳ (Finderben "/" névként jelenik meg)}if gi.dirs.count > 15 || gi.gameDirValue.count > 1900 {↳ a motor korlátai: 16 könyvtár, 2047 karakter    gi.problems.append("The game data is spread over too many folders. ...")}
launcher/GameRunner.swift:61 – a környezet összeállítása
func environment(gameDirs: [URL], headless: Bool = false, updates: Int = 0) -> [String: String] {    var env = ProcessInfo.processInfo.environment.filter { !$0.key.hasPrefix("LT_") && !$0.key.hasPrefix("NOLF_") }    ↳ tiszta lap: régi LT_/NOLF_ változók ki    env["NOLF_GAME_DIR"] = gameDirs.map { $0.path }.joined(separator: ":")    ↳ a megtalált mappák, ':'-tal    if headless {  // önteszt        env["LT_UPDATES"] = String(updates)        env["LT_STUB_QUIET"] = "1"        env["LT_SCREEN"] = "640x480"    } else {        env["LT_WINDOW"] = "1"  // ablakos futás        env["LT_REALTIME"] = "1"        env["LT_SCREEN"] = "\(width)x\(height)"        ↳ a választott felbontás        if software { env["LT_SOFTWARE"] = "1" } else { env["LT_METAL"] = "1" }    }    switch mode {    case .play, .mission:        break    case .viewer:  // pályanézegető: szerver nélkül        env["LT_NOSERVER"] = "1"        env["LT_WORLD"] = "WORLDS\\\(level.uppercased()).DAT"    }    if !bubbles { env["LT_NOPSRATE"] = "1" }    ↳ buborékok az akváriumban    if !bounce { env["LT_NOFLOORBOUNCE"] = "1" }    ↳ szikrák pattannak-e a padlón    if hungarian, let f = Self.hungarianFile { env["NOLF_LANG_FILE"] = f.path }    ↳ a csomagolt hu.txt    if enhance && !software {    ↳ "Képjavítás" kapcsoló = mindhárom szűrő félerővel        env["NOLF_SHARPEN"] = "0.5"        env["NOLF_GRADE"] = "0.5"        env["NOLF_BLOOM"] = "0.5"    }    return env}
launcher/GameRunner.swift:157 – a játék indítása (kivonat)
let p = Process()p.executableURL = exe  // NOLF1.app/Contents/Helpers/nolf1p.currentDirectoryURL = Paths.profile↳ ~/Library/Application Support/NOLF1/Profile -> ide mennek a mentésekp.environment = options.environment(gameDirs: dirs)↳ minden beállítás környezeti változóként, argumentum nincsp.standardOutput = handle↳ ~/Library/Logs/NOLF1/game-ÉÉÉÉHHNN-ÓÓPPMM.logp.standardError = handlep.terminationHandler = { [weak self] proc in↳ kilépéskor: rendes vége vagy összeomlás (jel)?    ...    self.state = reason == .uncaughtSignal ? .crashed(status) : .ended(status)}try p.run()handOverFocus(to: p.processIdentifier)↳ macOS 14+: a fókuszt kifejezetten át kell adni a játéknak

Fordítás lépésről lépésre

A) Xcode grafikus felületén

  1. git clone -b linux-port <repó> nolf1, vagy csomagold ki az offline forráscsomagot.
  2. Nyisd meg a NOLF1.xcodeproj-ot.
  3. Felül a sémaválasztóban: NOLF1 Launcher, célként My Mac.
  4. Mindhárom targetnél: Signing & Capabilities → a saját Team-ed, vagy „Sign to Run Locally”.
  5. ⌘+B (Build), majd ⌘+R (Run). Az Xcode a függőségek miatt előbb a nolfobject-et és a nolf1-et fordítja, majd beágyazza őket.
  6. Az indítóban: Choose… → a NOLF GOTY mappa → Play.

B) Parancssorból, ad-hoc aláírással

Terminal (macOS)
cd nolf1  # a repó gyökerexcodebuild -project NOLF1.xcodeproj -scheme "NOLF1 Launcher" -configuration Release \↳ a teljes app, Release-ben  -derivedDataPath build-mac \  ↳ a kimenet a repón belül, nem a ~/Library/Developer alatt  CODE_SIGN_IDENTITY=- CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM= \  ↳ "-" = ad-hoc aláírás, csapat nélkül  build 2>&1 | grep -E "error:|BUILD"  ↳ csak a hibák és a végeredményopen build-mac/Build/Products/Release/NOLF1.app  # indítás

C) DMG készítése (terjesztéshez)

Terminal (macOS)
mkdir -p /tmp/dmg && rm -rf /tmp/dmg/* && ditto build-mac/Build/Products/Release/NOLF1.app /tmp/dmg/NOLF1.app↳ ditto: megőrzi az aláírást és a jogokatln -s /Applications /tmp/dmg/Applications↳ "húzd ide" parancsikon az Alkalmazások mappárahdiutil create -volname "NOLF1 magyar" -srcfolder /tmp/dmg -format UDZO -ov NOLF1-magyar.dmg↳ UDZO = tömörített, csak olvasható
A bare motor futtatása Xcode-ból: a nolf1 sémát választva a motor közvetlenül indul, a sémában beállított LT_WINDOW=1 LT_METAL=1 LT_SCREEN=1024x768 LT_REALTIME=1 változókkal. A NOLF_GAME_DIR-t ehhez a séma Environment Variables részénél kell megadni. A billentyűk: gyorsmentés F6, gyorsbetöltés F9 (Mac-billentyűzeten fn+F6 / fn+F9).

Mac és Linux: ugyanaz a forrás, két út

macOSLinux
Build-eszközXcode / xcodebuildbash: forditas.sh → build_linux.sh
FordítóApple clangclang (LLVM)
Fájllistaszinkronizált mappák + kivételekglob + az eredeti .dsp SOURCE= sorai
Szerver modul.dylib, -undefined dynamic_lookup.so, -shared -Wl,-Bsymbolic, exe -rdynamic
Kis- és nagybetűa fájlrendszer nem különbözteti meglinux_case_links.py szimlinkjei
IndítóSwiftUI NOLF1.appplay_linux.sh (+ forditas.sh ikon asztali ikon)
GPUMetal, MSL futásidőben fordítvaOpenGL 4.6, GLSL futásidőben fordítva