Small improvements to README.macOS.md

This commit is contained in:
Matthias Melcher 2019-02-05 11:24:06 +01:00
parent 7d9d7dd7b8
commit d41ff666d0
1 changed files with 13 additions and 12 deletions

View File

@ -7,7 +7,7 @@ _README.macOS.md - Building FLTK under Apple macOS_
* [Contents](#contents)
* [Introduction](#introduction)
* [How to Build FLTK using _CMake_ AND _Xcode_](#build_cmake_xcode)
* [How to Build FLTK using _CMake_ and _Xcode_](#build_cmake_xcode)
* [Prerequisites](#bcx_prerequisites)
* [Downloading FLTK and Unpacking](#bcx_download)
* [Configuring FLTK](#bcx_config)
@ -60,13 +60,18 @@ All environments will generate Unix style static libraries and macOS style app b
This option is best for users who like to develop their apps using Apple's Xcode IDE. There
is no need to ever use a command line shell in this configuration.
This option requires an Apple ID and administrator rights.
This option requires an Apple ID and the Administrator password.
<a name="bcx_prerequisites"></a>
### Prerequisites (CMake, Xcode)
In order to build FLTK, you need to install _CMake_ and _Xcode_.
_Xcode_ is Apple's IDE (Integrated Devloper Environment) and can be downloaded via the
[App Store](https://itunes.apple.com/de/app/xcode/id497799835?l=en&mt=12). You will
need an Apple ID and administrator right for this. Installing _Xcode_ needs little to no
user input, but will likely take well over an hour.
"CMake is used to control the software compilation process using simple platform and
compiler independent configuration files, and generate native makefiles and workspaces
that can be used in the compiler environment of your choice."
@ -75,23 +80,19 @@ Please download and install the Mac OS X version of _CMake_ from
[www.cmake.org](https://cmake.org/download/). Download the .dmg file, click it, and when
the Finder window opens, drag the _CMake_ icon into the Applications folder.
_Xcode_ can be downloaded via the
[App Store](https://itunes.apple.com/de/app/xcode/id497799835?l=en&mt=12). You will
need an Apple ID and administrator right for this. Installing _Xcode_ will take well over an hour.
<a name="bcx_download"></a>
### Downloading and Unpacking (CMake, Xcode)
### Downloading FLTK and Unpacking (CMake, Xcode)
FLTK 1.4 is currently (as of Jan. 2019) only available as a source code repository via GitHub.
You will need to clone the repository to check out the source code onto your machine. This
has the great benefit that the source code can be updated later simply by telling _git_ to
_pull_ the newest release.
If you want to use _Xcode_ to clone the FLTK GitHub repository, you will have to set up a
GitHub Account in the _Xcode_ preferences. If you don't have a GitHub account, or don't
want to create one for _Xcode_, you can use still the command line
`git clone https://github.com/fltk/fltk.git fltk-1.4.git` to ceck out the repo.
If you want to use _Xcode_ to clone the FLTK GitHub repository, you will have to give _Xcode_
access to your GitHub Account in the _Xcode_ preferences. If you don't have a GitHub
account, or don't want to share your credentials with _Xcode_, you can use still the command
line `git clone https://github.com/fltk/fltk.git fltk-1.4.git`
to ceck out the repo.
Start _Xcode_. Select `Source Control >> Clone...` in the main menu.