From 9c424770d7f29de6b9dda1bf0163081e2fdb8a0a Mon Sep 17 00:00:00 2001 From: Mathieu Westphal Date: Fri, 6 Oct 2023 19:28:11 +0200 Subject: [PATCH] Improve macos doc (#1043) --- doc/user/INSTALLATION.md | 4 +++- doc/user/LIMITATIONS_AND_TROUBLESHOOTING.md | 10 ++++++++-- 2 files changed, 11 insertions(+), 3 deletions(-) diff --git a/doc/user/INSTALLATION.md b/doc/user/INSTALLATION.md index ff2b25bbcc..c0e161bca7 100644 --- a/doc/user/INSTALLATION.md +++ b/doc/user/INSTALLATION.md @@ -11,6 +11,8 @@ | Debian-based Package | [F3D-2.2.1-Linux.deb](https://github.com/f3d-app/f3d/releases/download/v2.2.1/F3D-2.2.1-Linux-x86_64-raytracing.deb) | | Linux (Portable) | [F3D-2.2.1-Linux.tar.xz](https://github.com/f3d-app/f3d/releases/download/v2.2.1/F3D-2.2.1-Linux-x86_64-raytracing.tar.xz) | +Note: MacOS package is not signed, see the [troubleshooting](LIMITATIONS_AND_TROUBLESHOOTING.md) section for a workaround if needed. + ## Alternatives You can find other (headless, older, smaller, checksum, RCs) release related packages and files on the [releases page](https://github.com/f3d-app/f3d/releases). @@ -43,4 +45,4 @@ You can also find packages for the following repositories: - [FreeBSD](https://cgit.freebsd.org/ports/tree/graphics/f3d) - [Spack](https://packages.spack.io/package.html?name=f3d) -- [pypi](https://pypi.org/project/f3d/) +- [pypi](https://pypi.org/project/f3d/) (library only) diff --git a/doc/user/LIMITATIONS_AND_TROUBLESHOOTING.md b/doc/user/LIMITATIONS_AND_TROUBLESHOOTING.md index 20b15196a1..b61bbf862d 100644 --- a/doc/user/LIMITATIONS_AND_TROUBLESHOOTING.md +++ b/doc/user/LIMITATIONS_AND_TROUBLESHOOTING.md @@ -95,9 +95,15 @@ Your previous F3D installation is current being used to generate thumbnails, wai ## macOS -> Using the binary release, I'm unable to run F3D because macOS warns about F3D not being signed. +> I'm unable to use the binary release, macOS complains the file is invalid or corrupted -F3D is not signed by Apple yet so macOS shows this warning. To run F3D, right click on the app and click "open", then click "open" again to be able to run F3D. +Our macOS binary package are not signed, to work around this, you can simply run the following command: + +``` +xattr -cr /Applications/F3D.app +``` + +Then F3D should work as expected. > Using the silicon binary release, I cannot find the raytracing feature or open exodus files