Warning, /graphics/digikam/project/bundles/appimage/README is written in an unsupported language. File is not indexed.

0001 RESUME
0002 ------
0003 These scripts build a binary digiKam AppImage bundle for Linux using Ubuntu 64 bits.
0004 
0005 
0006 AUTHORS
0007 -------
0008 
0009 (c) 2015-2024 by Gilles Caulier <caulier dot gilles at gmail dot com>
0010 
0011 
0012 DESCRIPTION
0013 -----------
0014 These files and scripts are used to make binary AppImage bundle of the digiKam
0015 Software Collection for Linux.
0016 
0017 For more information about AppImage, see at this url:
0018 http://appimage.org/
0019 
0020 In addition to this README, there are comments in the scripts that provide some
0021 additional explanation for how they work.
0022 
0023 
0024 BUNDLE CONTENTS
0025 ---------------
0026 
0027 Note: the bundle is rellocable.
0028 
0029 .
0030 └── usr
0031     ├── bin                                         Main executable
0032     │   ├── data                                    Marble data
0033     │   └── plugins                                 Marble plugins
0034     ├── lib                                         All Shared libraries, including 64 bits
0035     ├── lib64 -> lib                                Symbolic link, for compatibility
0036     ├── plugins                                     Qt5 based plugins
0037     │   ├── bearer
0038     │   ├── designer
0039     │   ├── generic
0040     │   ├── geoservices
0041     │   ├── iconengines
0042     │   ├── imageformats
0043     │   ├── kauth                                   KF5 authentication
0044     │   ├── kf5                                     Generic KF5 plugins
0045     │   ├── mediaservice
0046     │   ├── org.kde.kglobalaccel5.platforms         KF5 global accelerators
0047     │   ├── platforminputcontexts
0048     │   ├── platforms
0049     │   ├── playlistformats
0050     │   ├── position
0051     │   ├── sensorgestures
0052     │   ├── sensors
0053     │   ├── sqldrivers
0054     │   ├── webkit
0055     │   └── xcbglintegrations
0056     ├── share                                       Shared data files
0057     │   ├── digikam                                 digiKam
0058     │   ├── knotifications5                         KF5
0059     │   ├── kservices5                              KF5
0060     │   ├── kservicetypes5                          KF5
0061     │   ├── kxmlgui5                                KF5
0062     │   ├── lensfun                                 Lens database for Lensfun
0063     │   ├── locale                                  KF5 i18n
0064     │   ├── metainfo                                Application metadata
0065     │   ├── OpenCV                                  OpenCv shared lib data
0066     │   └── solid                                   KF5 Solid
0067     └── translations                                Qt5 i18n
0068 
0069 
0070 REQUIREMENTS
0071 ------------
0072 
0073 - For technical reasons about compatibility with libc, Ubuntu 18.04 is used to be compatible
0074   at run-time under other Linux distributions. NOTE: we have tested Centos in the pass but
0075   this distribution is really a puzzle to group all required multimedia packages.
0076 
0077 - Create a fresh XUbuntu 18.04 environment in a Virtual Machine:
0078   Install the distribution using official ISO from http://ftp.free.fr/mirrors/ftp.xubuntu.com/releases/18.04.5/release/
0079   or another mirror.
0080   Use a static 80Gb virtual disk with separated partitions as 50Gb for /, 8Gb for swap, and 23Gb for /home.
0081 - Using XUbuntu allow to not use Plasma or Gnome desktop. Light XFCE desktop is not Qt5 based desktop.
0082   Setup the Internet repositories and install update.
0083 - Install the minimum requirement to checkout the code:
0084   apt install git openssh-askpass
0085   git clone https://invent.kde.org/graphics/digikam.git DK
0086   cd DK/project/appimage/
0087 
0088 - Customize the config.sh file:
0089   Setup the digiKam git tags to checkout right source code in bundle.
0090   Setup the option to host debug symbols or not in bundle.
0091 
0092 
0093 COMPONENTS
0094 ----------
0095 There are 4 scripts to be run by the user. 2 first ones installs
0096 components on Mageia 7 and all dependencies, next one digiKam, and last one makes a
0097 binary AppImage bundle for Linux.
0098 
0099 
0100 SCRIPT DESCRIPTIONS
0101 -------------------
0102 All scripts should be run from within this directory.
0103 
0104 * 01-build-host.sh:
0105 
0106 This script downloads and configures all packages for Mageia 7 to compile digiKam, KF5, Qt5,
0107 and all other important low level libraries. When the system is ready, this script compile
0108 and install low level and Qt5 libraries.
0109 
0110 * 02-build-extralibs.sh:
0111 
0112 This script configures, compile, and install KF5 frameworks and Marble.
0113 
0114 * 03-build-digikam.sh:
0115 
0116 This script configures, and compile digiKam.
0117 
0118 * 04-build-installer.sh:
0119 
0120 Once you've successfully built digiKam, this script create the AppImage bundle.
0121 This include applications documentations and translations.
0122 Depending of configuration done in config.sh, this script is able to upload automatically
0123 the bundle file on files.kde.org digiKam area through ssh. A valid ssh key configured
0124 with remote KDE server need to be set previously with the account. You can load ssh key
0125 at startup following these instructions:
0126 
0127 1/ As root, mkdir /root/.ssh
0128 2/ Put your ssh keys in /root/.ssh
0129 3/ Install openssh-ask-pass package.
0130 4/ Edit /root/.bashrc and add these lines at end:
0131 
0132 # --- ssh key rules
0133 
0134 eval `SSH_ASKPASS=/usr/libexec/openssh/x11-ssh-askpass /usr/bin/keychain -q --eval --noask --agents ssh ~/.ssh/id_rsa`
0135 
0136 # ---
0137 
0138 Note: the bundle can be signed with GPG. You must setup your private and public keys before
0139 and put your passphare to a text file (~/.gnupg/dkorg-gpg-pwd.txt)
0140 
0141 5/ Re-login as root to setup password.
0142 
0143 Source : https://unix.stackexchange.com/questions/90853/how-can-i-run-ssh-add-automatically-without-password-prompt
0144 
0145 * makeall.sh
0146 
0147 This script permit to build whole Linux bundle from scratch in one time.
0148 
0149 * update.sh
0150 
0151 This script re-build only digiKam and Linux bundle.
0152 
0153 
0154 AT RUN-TIME ON TARGET COMPUTER
0155 ------------------------------
0156 - Make AppImage file executable (CentOS : chmod +x _bundle_file_).
0157 - Add Fuse on on computer       (CentOS : yum install fuse).
0158 - Add user right to use Fuse    (CentOS : usermod -a -G fuse _user_name_).
0159 
0160 
0161 LICENSES
0162 --------
0163 The scripts and other contents of this package are licensed under the BSD-3-Clause License.