This is a fork of the official PLCrashReporter repository. It is maintained by the App Center team and based on PLCrashReporter 1.2.1 (commit fda23306) with additional fixes and changes. It was created for use in the following SDKs:
Please note that this fork is based on version 1.2.1 of PLCrashReporter and not 1.3 which is currently in
masterof the official repository.
The focus of this fork is to add new features to PLCrashReporter (e.g. support for tvOS or the new arm64e CPU architecture). To keep changes to a minimum, this fork deliberately does not address compile-time warnings. That said, the fork has been battle-tested in the SDKs mentioned above. At this time, we are hoping to contribute our changes to the official PLCrashReporter repository and are talking to the team at Plausible Labs.
Please check out our change log.
The easiest way to use PLCrashReporter is by using AppCenter. However, if you want to use PLCrashReporter directly, grab the latest release at https://github.com/Microsoft/PLCrashReporter/releases and check out the official PLCrashReporter documentation.
- A Mac
- Xcode 10.1
- Doxygen to generate the documentation. See the official Doxygen repository for more information or use Homebrew to install it.
- GraphViz to generate the documentation. See the official GraphViz website for more information or use Homebrew to install it.
protobuf-cto convert Protocol Buffer.protofiles to C descriptor code. See the official protobuf-c repository for more information or use Homebrew to install it.
-
Open a new window for your Terminal.
-
Go to PlCrashReporter's root folder and run
xcodebuild BITCODE_GENERATION_MODE=bitcode OTHER_CFLAGS="-fembed-bitcode" -configuration Release -target 'Disk Image'
to create binaries for all platforms.
-
Verify that your iOS and tvOS binaries have Bitcode enabled by running
otool -l build/Release-appletv/CrashReporter.framework/Versions/A/CrashReporter | grep __LLVM(adjust the path to the binary as necessary). If you see some output, it means the binary is Bitcode enabled.
As Bitcode versions are not backward compatible, it is required to build an SDK or component with the minimum Xcode version that the SDK needs to support. In the past, this meant that you would simply build PLCrashReporter with the oldest Xcode version that you care about. With the introduction of the arm64e CPU architecture in Fall 2018, things got more complicated.
To ensure PLCrashReporter supports apps that use Xcode 8.3.3, it needs to be built using Xcode 8.3.3. At the same time, PLCrashReporter 1.2.3-rc1 and later support the arm64e CPU architecture. The arm64e architecture can only be built with Xcode 10.1 and later and is currently in preview (check out the Xcode 10.1 release notes for more information). To reconcile both backward compatibility with Xcode 8 and support for arm64e CPUs, you need to build all architecture slices of PLCrashReporter-iOS using Xcode 8.3.3 and then merge them using the lipo-tool with an arm64e slice that was built with Xcode 10.1 and up. To make this easier, we have updated the script that creates the CrashReporter-iOS binary.
- Install the prerequisites as explained in 1.3.1 above.
- Install Xcode 10.1 and the oldest Xcode version that you care about, i.e. Xcode 8.3.3 in parallel (information on how to do that can be found at https://medium.com/@hacknicity/working-with-multiple-versions-of-xcode-e331c01aa6bc.
- Make sure you are using the old version of Xcode by running
xcode-select -p. It should point to your oldest Xcode version. If it points to a newer version, e.g. Xcode 10.1, usesudo xcode-select -s PATH_TO_OLD_XCODEto switch to the old Xcode version.
-
Open your Terminal.
-
Go to PLCrashReporter's root folder and run
xcodebuild PL_ARM64E_XCODE_PATH="Path to your Xcode 10.1 installation" BITCODE_GENERATION_MODE=bitcode OTHER_CFLAGS="-fembed-bitcode" -configuration Release -target 'Disk Image'
This will create binaries for all platforms and adds support for arm64e to PLCrashReporter-iOS. Note the environment variable
PL_ARM64E_XCODE_PATH. Make sure to set it to your latest Xcode version that supports arm64e, currently Xcode 10.1. -
Verify that your iOS and tvOS binaries have Bitcode enabled by running
otool -l build/Release-appletv/CrashReporter.framework/Versions/A/CrashReporter | grep __LLVM(adjust the path to the binary as necessary). If you see some output, it means the binary is Bitcode enabled.
We are looking forward to your contributions via pull requests.
To contribute to PLCrashReporter, you need the tools mentioned in 1.3.3.1 above to build PLCrashReporter for all architectures.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
PLCrashReporter has a dependency on Protocol Buffers implementation in C as a git submodule. Use below command to clone PLCrashReporter repository or update the repository if you have already cloned it.
git clone --recursive https://github.com/microsoft/PLCrashReporter-Fork.git
git submodule update --init --recursive
This fork of the official PLCrashReporter repository is maintained by the team of Visual Studio App Center. For general information about PLCrashReporter, please visit the official PLCrashReporter website.
We're on Twitter as @vsappcenter.