Please see our official documentation.
- Install the build dependencies (Ubuntu used as an example):
sudo apt install --no-install-recommends build-essential cmake git libgnutls28-dev
sudo wget -O /usr/local/bin/appimagecraft-x86_64.AppImage https://github.com/TheAssassin/appimagecraft/releases/download/continuous/appimagecraft-x86_64.AppImage
sudo chmod +x /usr/local/bin/appimagecraft-x86_64.AppImage- Get the Qt online installer from: https://www.qt.io/download-qt-installer-oss
- During installation, choose Qt 6.7, CMake and Qt Creator.
git clone --depth 1 https://github.com/t3gemstone/gem-imagerModify appimagecraft.yml:
- First, you must set Qt6_ROOT (as a extra_variables item under build/cmake) to the root of your Qt6 installation. eg:
/opt/Qt/6.7.2/gcc_64/or$HOME/Qt/6.7.2/gcc_64/ - Second, you must set QMAKE (as a raw_environment variable of the linuxdeploy plugin) to the full path of qmake inside that Qt6 installation. eg:
/opt/Qt/6.7.2/gcc_64/bin/qmakeor$HOME/Qt/6.7.2/gcc_64/bin/qmake
Now, use AppImageCraft to build your AppImage:
cd gem-imager
export Qt6_ROOT="$HOME/Qt/6.7.2/gcc_64"
export QMAKE="$Qt6_ROOT/bin/qmake"
export LD_LIBRARY_PATH="$Qt6_ROOT/lib"
./${your_platform_appimagecraft}.AppImageNow mark the AppImage as executable, and run it:
chmod +x ./GemstoneImager-*.AppImage
./GemstoneImager-*.AppImage-
Get the Qt online installer from: https://www.qt.io/download-open-source During installation, choose Qt 6.7 with Mingw64 64-bit toolchain, CMake and Qt Creator.
-
For building the installer, get Nullsoft scriptable install system: https://nsis.sourceforge.io/Download
-
It is assumed you already have a valid code signing certificate, and the Windows 10 Kit (SDK) installed.
Building Gemstone Imager on Windows is best done with the Qt Creator GUI.
- Download source .zip from github and extract it to a folder on disk
- Open src/CMakeLists.txt in Qt Creator.
- Use Qt Creator to set the MINGW64_ROOT CMake variable to your MingGW64 installation path, eg
C:\Qt\Tools\mingw64 - For builds you distribute to others, make sure you choose "Release" in the toolchain settings and not the Debug configuration.
- Menu "Build" -> "Build all"
- Result will be in build_gem-imager_someversion
- Go to the BUILD folder, right click on the .nsi script "Compile NSIS script", to create installer.
- Get the Qt online installer from: https://www.qt.io/download-open-source During installation, choose Qt 6.7, CMake and Qt Creator.
- It is assumed you have an Apple developer subscription, and already have a "Developer ID" code signing certificate for distribution outside the Mac Store.
- Download source .zip from github and extract it to a folder on disk
- Start Qt Creator and open src/CMakeLists.txt
- Use Qt Creator to set the Qt6_ROOT CMake variable to your Qt6 installation path, eg
/opt/Qt6/6.7.2/gcc_64 - Menu "Build" -> "Build all"
- Result will be in build_gem-imager_someversion
- For distribution to others:
- Use the IMAGER_SIGNED_APP flag to enable Application signing
- Use the IMAGER_SIGNING_IDENTITY string to specify the Developer ID certificate Common Name
- Use the IMAGER_NOTARIZE_APP flag to enable notarization as part of the build
- Use the IMAGER_NOTARIZE_KEYCHAIN_PROFILE string to specify the name of the keychain item containing your Apple ID credentials for notarizing.
If the application is started with "--repo [your own URL]" it will use a custom image repository. So can simply create another 'start menu shortcut' to the application with that parameter to use the application with your own images.
The main code of the Imaging Utility is made available under the terms of the Apache license. See license.txt and files in "src/dependencies" folder for more information about the various open source licenses that apply to the third-party dependencies used such as Qt, libarchive, drivelist, mountutils and libcurl. For the embedded (netboot) build see also "embedded/legal-info" for more information about the extra system software included in that.