X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=INSTALL.markdown;h=5a74557d07c7f8de91ecdfec3ae684ac8112a8e2;hb=3f9c2ecf18d8fa37fad5a7062f80952692eaa8e7;hp=94e2d631cc0a8450e37cd1a04fd65209afe2e427;hpb=31278e9096e161f3ab8eb886c480560f17282412;p=apitrace diff --git a/INSTALL.markdown b/INSTALL.markdown index 94e2d63..5a74557 100644 --- a/INSTALL.markdown +++ b/INSTALL.markdown @@ -16,7 +16,7 @@ Requirements common for all platforms: The GUI also dependends on: -* Qt version 4.7 +* Qt version 4.7 or higher (tested with version 4.8) * QJSON version 0.5 or higher (tested with version 0.7.1, which is bundled) @@ -35,13 +35,22 @@ tracing. Linux / Mac OS X ---------------- +Additional optional dependencies for Linux: + +* libprocps (procps development libraries) + +* libdwarf + Build as: - cmake -H. -Bbuild + cmake -H. -Bbuild -DCMAKE_BUILD_TYPE=RelWithDebInfo make -C build -You can also build the 32bit GL wrapper on 64bit distro with a multilib gcc by -doing: +Other possible values for `CMAKE_BUILD_TYPE` `Debug`, `Release`, +`RelWithDebInfo`, and `MinSizeRel`. + +You can also build the 32-bits GL wrapper on a 64-bits distribution, provided +you have a multilib gcc and 32-bits X11 libraries, by doing: cmake \ -DCMAKE_C_FLAGS=-m32 \ @@ -52,6 +61,10 @@ doing: -H. -Bbuild32 make -C build32 glxtrace +The `/usr/lib32` refers to the path where the 32-bits shared objects are may +differ depending on the actual Linux distribution. + + Android ------- @@ -65,6 +78,19 @@ Build as: cmake -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain/android.toolchain.cmake -DANDROID_API_LEVEL=9 -H. -Bbuild make -C build +You can also choose a particular ABI by passing `ANDROID_ABI` variable to +cmake, e.g., `-DANDROID_ABI=x86`. + +FirefoxOS +--------- + +Put Apitrace source tree into `B2GROOT/external/apitrace/` and the `Android.mk` +file (`B2GROOT/external/apitrace/Android.mk`) will do the needful to compile +and install apitrace appropriately into the system image as part of FirefoxOS +build process. It expects a linaro-type of Android NDK to be present in +`../../prebuilt/ndk/android-ndk-r7` (ie `B2GROOT/prebuilt/ndk/android-ndk-r7`). + + Windows ------- @@ -98,6 +124,10 @@ It will try to detect most required/optional dependencies automatically. When not found automatically, you can manually specify the location of the dependencies from the CMake GUI. +Qt on Windows doesn't ship with 64-bit binaries, you may want to add +`-DENABLE_GUI=FALSE` to the above cmake command line for Windows 64-bits +builds. + After you've successfully configured, you can start the build by opening the generated `build\apitrace.sln` solution file, or invoking CMake as: