Add documentation about macOS to Developer Docs (#3415)

This commit is contained in:
Bart Louwers
2025-04-21 18:47:21 +02:00
committed by GitHub
parent a809039bae
commit 3eba74d1ac
18 changed files with 141 additions and 58 deletions

View File

@@ -1,34 +1,5 @@
# MapLibre Native for macOS
# MapLibre Native on macOS
[![GitHub Action build status](https://github.com/maplibre/maplibre-native/workflows/macos-ci/badge.svg)](https://github.com/maplibre/maplibre-native/actions/workflows/macos-ci.yml)
Clone the repo:
```sh
git clone --recurse-submodules git@github.com:maplibre/maplibre-native.git
```
Install needed tooling and dependencies with Homebrew. See [macos-ci.yml](https://github.com/maplibre/maplibre-native/blob/main/.github/workflows/macos-ci.yml) for the most up-to-date dependencies.
Optionally configure Bazel:
```sh
cp platform/darwin/bazel/example_config.bzl platform/darwin/bazel/config.bzl
```
Create and open Xcode project:
```sh
bazel run //platform/macos:xcodeproj --@rules_xcodeproj//xcodeproj:extra_common_flags="--//:renderer=metal
xed platform/macos/MapLibre.xcodeproj
```
Build and run AppKit sample app directly from the command line:
```sh
bazel run //platform/macos/app:macos_app --//:renderer=metal
```
---
The MapLibre Organization does not officially support the macOS to the same extent as iOS (see [project tiers](https://github.com/maplibre/maplibre/blob/main/PROJECT_TIERS.md)). However, bug reports and pull requests are certainly welcome.
Refer to the [MapLibre Native Developer Guide](https://maplibre.org/maplibre-native/docs/book/platforms/macos/index.html) to learn how to build the project for macOS.