diff options
| -rw-r--r-- | README.macos | 58 |
1 files changed, 36 insertions, 22 deletions
diff --git a/README.macos b/README.macos index cde1360559..4b013dbc82 100644 --- a/README.macos +++ b/README.macos @@ -22,16 +22,27 @@ Qt packages and source code from or use the tools/macos-setup.sh script described below. +You should have CMake installed; you can download binary distributions +for macOS from + + https://cmake.org/download/ + +The Wireshark source includes an autoconf configure script; however, +that script cannot find recent versions of Qt for macOS, and will not +try to find macOS frameworks that Wireshark can use to improve the user +experience, so we don't recomment using the configure script. + The tools/macos-setup.sh script can be used to download, patch as necessary, build as necessary, and install those libraries and the -libraries on which they depend; it will, by default, also install other -libraries that can be used by Wireshark and TShark. The versions of -libraries to download are specified by variables set early in the -script; you can comment out the settings of optional libraries if you -don't want them downloaded and installed. Before running the -tools/macos-setup.sh script, and before attempting to build Wireshark, -make sure your PKG_CONFIG_PATH environment variable's setting includes -both /usr/X11/lib/pkgconfig and /usr/local/lib/pkgconfig. +libraries on which they depend, along with tools such as CMake; it will, +by default, also install other libraries that can be used by Wireshark +and TShark. The versions of libraries and tools to download are +specified by variables set early in the script; you can comment out the +settings of optional libraries if you don't want them downloaded and +installed. Before running the tools/macos-setup.sh script, and before +attempting to build Wireshark, make sure your PKG_CONFIG_PATH +environment variable's setting includes both /usr/X11/lib/pkgconfig and +/usr/local/lib/pkgconfig. The tools/macos-setup.sh script must be run from the top-level source directory. @@ -48,25 +59,28 @@ elsewhere, such as After you have installed those libraries: -If you are building from a Git tree, rather than from a source -distribution tarball, run the autogen.sh script. This should not be -necessary if you're building from a source distribution tarball, unless -you've added new source files to the Wireshark source. + make a directory in which Wireshark is to be built, separate + from the top-level source directory for Wireshark - it can be a + subdirectory of that top-level source directory; -Then run the configure script, and run make to build Wireshark. + cd to that directory, and run CMake, with an argument that is a + path to the top-level source directory; -If you upgrade the major release of macOS on which you are building -Wireshark, we advise that, before you do any builds after the upgrade, -you do, in the build directory: + when CMake finishes, run make to build Wireshark. - If you are building from a release tarball: - make distclean +For example, to build Wireshark in a subdirectory of the top-level +source directory, named "build", do, from the top-level source +directory; - If you are building from Git: - make maintainer-clean - ./autogen.sh + mkdir build + cd build + cmake .. + make -Then re-run the configure script and rebuild from scratch. +If you upgrade the major release of macOS on which you are building +Wireshark, we advise that, before you do any builds after the upgrade, +you remove the build directory and all its subdiretories, and repeat the +above process, re-running CMake and rebuilding from scratch. On Snow Leopard (10.6) and later releases, if you are building on a machine with a 64-bit processor (with the exception of the early Intel |