axolotl has a few different installation options in place.
Below is a list describing the tooling and dependencies required to use them.
Tooling
This requires clickable to be installed locally.
Installation instructions can be found here.
Dependencies
The following build dependencies are required:
- Docker
- Go
The following translation dependencies are required:
sudo apt-get install gettext
The following go-qml dependencies are required:
sudo add-apt-repository ppa:ubuntu-sdk-team/ppa
sudo apt-get update
sudo apt-get install qtdeclarative5-dev qtbase5-private-dev qtdeclarative5-private-dev libqt5opengl5-dev qtdeclarative5-qtquick2-plugin
sudo ln -s /usr/include/x86_64-linux-gnu/qt5/QtCore/5.9.1/QtCore /usr/include/
To install all go dependencies, use go mod download.
Build and Install
To run the default set of sub-commands, simply run clickable in the root directory. Clickable will attempt to auto detect the build template and other configuration options.
This also transfers the click package to the Ubuntu Touch Phone.
clickable
Run
clickable launch
Clickable supports a few different parameters.
For example, clickable launch logs to start signal and get logging output.
For a full list of available clickable commands, see here.
Tooling
This requires snap and snapcraft to be installed locally.
Installation instructions for snapcraft can be found here.
Dependencies
Snapcraft manages its own dependencies.
Build and Install
The Snap template used for the installation can be found in the /snap subdirectory.
To build the application, use the following command from the root of this repository.
sudo snapcraft
To install the built snap, use snap:
sudo snap install axolotl_0.8.9_amd64.snap --dangerous
Run
To start the application, either search for "Axolotl" in your app drawer or start it with the below command.
snap run axolotl
Tooling
This requires flatpak and flatpak-builder to be installed locally.
Installation instructions can be found here
Dependencies
The following Flatpak SDKs are required:
flatpak install org.freedesktop.Platform//20.08
flatpak install org.freedesktop.Sdk//20.08
flatpak install org.freedesktop.Sdk.Extension.golang//20.08
flatpak install org.freedesktop.Sdk.Extension.node12//20.08
Build and Install
Installation can be done user-level or system-wide.
To list installed applications and/or runtimes, use flatpak list.
The Flatpak manifest used for the installation can be found in the /flatpak subdirectory.
User-level:
flatpak-builder --user --install build ./flatpak/org.nanuc.Axolotl.yml
System-wide:
Note that this requires root.
sudo flatpak-builder --install build ./flatpak/org.nanuc.Axolotl.yml
Run
To start the application, either search for "Axolotl" in your app drawer or start it with the below command.
flatpak run org.nanuc.Axolotl
Tooling
This requires appimagetool, go and npm to be installed locally.
Installation instructions for appimagetool can be found here
Build and Install
AppImage does not really have a concept of install, just execute the build script to compile and put all files in place. The build files are stored in /build/AppDir.
cd appimage
./build.sh
Run
To start the application, execute the AppImage binary directly:
If needed, set the file as executable with chmod +x Axolotl-x86_64.AppImage first.
./Axolotl-x86_64.AppImage
This requires clickable and snapcraft to be installed. It also requires the axolotl-web bundle to already be built. see build.sh