#
# Helper module to build macOS version of various source ports
# Copyright (C) 2020-2024 Alexey Lysiuk
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see .
#
import argparse
import os
import shutil
import subprocess
import typing
from pathlib import Path
from platform import machine
from .packaging.version import Version
from .state import BuildState
from .target import targets
from .target.base import Target
from .utility import (
OS_VERSION_ARM64,
OS_VERSION_X86_64,
CaseInsensitiveDict,
CommandLineOptions,
TargetPlatform,
symlink_directory,
)
class Builder(object):
def __init__(self, args: list):
self._targets = CaseInsensitiveDict({target.name: target for target in targets()})
arguments = self._parse_arguments(args)
state = self._state = BuildState()
state.xcode = arguments.xcode
state.instrument_functions = arguments.instrument_functions
state.verbose = arguments.verbose
self._platforms: typing.List[TargetPlatform] = []
self._populate_platforms(arguments)
state.platform = self._platforms[0]
if arguments.temp_path:
state.temp_path = Path(arguments.temp_path).absolute()
state.environment['TMPDIR'] = str(state.temp_path) + os.sep
os.makedirs(state.temp_path, exist_ok=True)
if arguments.source_path:
state.source_path = Path(arguments.source_path).absolute()
if arguments.target:
self._target = self._targets[arguments.target]
state.source = state.source_path / self._target.name
state.external_source = False
os.makedirs(state.source_path, exist_ok=True)
else:
assert arguments.source
state.source = Path(arguments.source).absolute()
state.external_source = True
self._detect_target()
for target in self._targets.values():
if target != self._target:
target.initialize(state)
del self._targets
if arguments.build_path:
state.build_path = Path(arguments.build_path).absolute()
else:
state.build_path = state.root_path / 'build' / self._target.name / ('xcode' if state.xcode else 'make')
if arguments.output_path:
state.output_path = Path(arguments.output_path).absolute()
else:
state.output_path = state.root_path / 'output'
self._environment = state.environment
state.static_moltenvk = arguments.static_moltenvk
state.quasi_glib = arguments.quasi_glib
state.jobs = arguments.jobs and arguments.jobs or self._get_default_job_count()
def _get_default_job_count(self):
args = ('sysctl', '-n', 'hw.ncpu')
result = subprocess.run(args, check=True, env=self._environment, stdout=subprocess.PIPE)
return result.stdout.decode('ascii').strip()
def _populate_platforms(self, arguments):
state = self._state
def adjust_sdk_path(path: str) -> Path:
if path:
return Path(path).absolute()
sdk_probe_path = state.root_path / 'sdk' / f'MacOSX{os_version}.sdk'
return sdk_probe_path if sdk_probe_path.exists() else None
if not arguments.disable_x64:
os_version = Version(arguments.os_version_x64) if arguments.os_version_x64 else OS_VERSION_X86_64
assert os_version >= OS_VERSION_X86_64, f'macOS {os_version} is not supported'
sdk_path = adjust_sdk_path(arguments.sdk_path_x64)
platform = TargetPlatform('x86_64', 'x86_64-apple-darwin', os_version, sdk_path, state.prefix_path)
self._platforms.append(platform)
if not arguments.disable_arm:
os_version = Version(arguments.os_version_arm) if arguments.os_version_arm else OS_VERSION_ARM64
assert os_version >= OS_VERSION_ARM64, f'macOS {os_version} is not supported'
sdk_path = adjust_sdk_path(arguments.sdk_path_arm)
platform = TargetPlatform('arm64', 'aarch64-apple-darwin', os_version, sdk_path, state.prefix_path)
self._platforms.append(platform)
assert len(self._platforms) > 0
# Put native platform first in the list of platforms
if self._platforms[0].architecture == machine():
return
for platform in self._platforms:
if platform.architecture == machine():
native_platform = platform
self._platforms.remove(platform)
self._platforms.insert(0, native_platform)
break
def run(self):
state = self._state
target = self._target
target.prepare_source(state)
if target.destination == Target.DESTINATION_DEPS:
state.install_path = state.deps_path / target.name
elif target.destination == Target.DESTINATION_OUTPUT:
state.install_path = state.output_path / target.name
assert state.install_path
if not state.xcode and state.install_path.exists():
shutil.rmtree(state.install_path)
self._create_prefix_directory()
if version := state.source_version():
print(f'Building {version}')
if target.multi_platform and not state.xcode:
self._build_multiple_platforms(target)
else:
self._build(target)
def _build(self, target: Target):
state = self._state
state.environment = self._environment.copy()
state.options = CommandLineOptions()
target.configure(state)
target.build(state)
target.post_build(state)
def _build_multiple_platforms(self, target: Target):
assert target.multi_platform
state = self._state
base_build_path = state.build_path
base_install_path = state.install_path
install_paths = []
for platform in self._platforms:
if platform.architecture in target.unsupported_architectures:
continue
state.platform = platform
state.build_path = base_build_path / ('build_' + platform.architecture)
if platform.architecture == machine():
state.native_build_path = state.build_path
state.install_path = base_build_path / ('install_' + platform.architecture)
self._build(target)
install_paths.append(state.install_path)
self._merge_install_paths(install_paths, base_install_path)
@staticmethod
def _compare_files(paths: typing.Sequence[Path]) -> bool:
content = None
for path in paths:
if not path.exists():
return False
with path.open('rb') as f:
if content:
if content != f.read():
return False
else:
content = f.read()
return True
def _merge_file(self, src: Path, src_sub_paths: typing.Sequence[Path], dst_path: Path):
if src.is_symlink():
shutil.copy(src_sub_paths[0], dst_path, follow_symlinks=False)
return
with open(src, 'rb') as f:
header = f.read(8)
is_executable = header[:4] == b'\xcf\xfa\xed\xfe'
is_library = header == b'!\n'
if is_executable or is_library:
# Merge executable and library files
dst_file = dst_path / src.name
args: typing.List[typing.Union[str, Path]] = ['lipo']
args += src_sub_paths
args += ['-create', '-output', dst_file]
subprocess.run(args, check=True, env=self._environment)
# Apply ad-hoc code signing on executable files outside of application bundles
if is_executable and '.app/Contents/' not in str(src):
args = ['codesign', '--sign', '-', dst_file]
subprocess.run(args, check=True, env=self._environment)
else:
if not Builder._compare_files(src_sub_paths):
print(f'WARNING: Source files for {dst_path / src.name} don\'t match')
shutil.copy(src_sub_paths[0], dst_path)
def _merge_missing_files(self, src_paths: typing.Sequence[Path], dst_path: Path):
shifted_src_paths = [path for path in src_paths]
last_path_index = len(src_paths) - 1
for _ in range(last_path_index):
shifted_src_paths.append(shifted_src_paths[0])
del shifted_src_paths[0]
if not shifted_src_paths[0].exists():
continue
self._merge_install_paths(shifted_src_paths, dst_path, missing_files_only=True)
def _merge_install_paths(self, src_paths: typing.Sequence[Path], dst_path: Path, missing_files_only=False):
if len(src_paths) == 0:
return
if not missing_files_only:
if dst_path.exists():
shutil.rmtree(dst_path)
os.makedirs(dst_path, exist_ok=True)
for src in src_paths[0].iterdir():
src_sub_paths = [path / src.name for path in src_paths]
if src.is_dir():
self._merge_install_paths(src_sub_paths, dst_path / src.name, missing_files_only)
elif src.name.endswith('.la'):
# Skip libtool files
continue
elif missing_files_only:
for src_sub_path in src_sub_paths[1:]:
if not src_sub_path.exists():
shutil.copy(src_sub_paths[0], dst_path)
else:
self._merge_file(src, src_sub_paths, dst_path)
if not missing_files_only:
self._merge_missing_files(src_paths, dst_path)
def _create_prefix_directory(self):
state = self._state
os.makedirs(state.prefix_path, exist_ok=True)
cleanup = True
for dep in state.deps_path.iterdir():
if dep.is_dir():
symlink_directory(dep, state.prefix_path, cleanup)
# Do symlink cleanup only once
cleanup = False
Builder._remove_empty_directories(state.prefix_path)
@staticmethod
def _remove_empty_directories(path: Path) -> int:
content: typing.List[str] = os.listdir(path)
count = len(content)
removed = 0
for entry in content:
abspath = path / entry
if os.path.isdir(abspath):
removed += Builder._remove_empty_directories(abspath)
if count == removed:
os.rmdir(path)
removed = 1
return removed
def _detect_target(self):
for name, target in self._targets.items():
if target.detect(self._state):
self._target = self._targets[name]
break
assert self._target
def _parse_arguments(self, args: list):
assert self._targets
parser = argparse.ArgumentParser(description='*ZDoom binary dependencies for macOS')
excl_group = parser.add_mutually_exclusive_group(required=True)
excl_group.add_argument('--target', choices=self._targets.keys(), help='target to build')
excl_group.add_argument('--source', metavar='path', help='path to target\'s source code')
group = parser.add_argument_group('Configuration options')
group.add_argument('--xcode', action='store_true', help='generate Xcode project instead of build')
group.add_argument('--instrument-functions', action='store_true', help='generate instrumentation calls')
group.add_argument('--os-version-x64', metavar='version', help='macOS deployment version for x86_64')
group.add_argument('--os-version-arm', metavar='version', help='macOS deployment version for ARM64')
group.add_argument('--verbose', action='store_true', help='enable verbose build output')
group.add_argument('--jobs', help='number of parallel compilation jobs')
excl_group = parser.add_mutually_exclusive_group()
excl_group.add_argument('--disable-x64', action='store_true', help='disable x86_64 support')
excl_group.add_argument('--disable-arm', action='store_true', help='disable ARM64 support')
group = parser.add_argument_group('Paths')
group.add_argument('--source-path', metavar='path',
help='path to store downloaded and checked out source code')
group.add_argument('--build-path', metavar='path', help='target build path')
group.add_argument('--output-path', metavar='path', help='output path for main targets')
group.add_argument('--temp-path', metavar='path', help='path to temporary files directory')
group.add_argument('--sdk-path-x64', metavar='path', help='path to macOS SDK for x86_64')
group.add_argument('--sdk-path-arm', metavar='path', help='path to macOS SDK for ARM64')
group = parser.add_argument_group('Hacks')
group.add_argument('--static-moltenvk', action='store_true', help='link with static MoltenVK library')
group.add_argument('--quasi-glib', action='store_true', help='link with QuasiGlib library')
return parser.parse_args(args)