|
||
---|---|---|
Sources | ||
data | ||
.gitignore | ||
LICENSE.md | ||
Package.swift | ||
README.md | ||
io.github.AparokshaUI.AdwaitaTemplate.json |
README.md
Adwaita Template
Adwaita Template is a template application for the Adwaita package.
Table of Contents
Installation
Install the Swift 5 Freedesktop SDK Extension
- Install
flatpak
. - Add Flathub to Flatpak:
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
- Install the newest version of the Freedesktop SDK:
flatpak install flathub org.freedesktop.Sdk
- Install the LLVM 16 Freedesktop extension:
flatpak install flathub org.freedesktop.Sdk.Extension.llvm16/x86_64/23.08
- Install the GNOME SDK. It's not required for building the Swift Freedesktop SDK extension, but later for building the application:
flatpak install flathub org.gnome.Sdk
- Install the Swift 5 Freedesktop SDK Extension.
flatpak install flathub org.freedesktop.Sdk.Extension.swift5
Install Other Tools
The following tools are required or recommended for editing this repository:
Usage
- Open this project in GNOME Builder. Copy the path to the containing folder of this file (in the sidebar) and replace the following piece of text in the
io.github.AparokshaUI.AdwaitaTemplate.json
file:
https://github.com/AparokshaUI/AdwaitaTemplate
with the following syntax (replace /path/to/directoy
):
file:///path/to/directory
- Build and run the application.
- Change the app's name and other information about the application in the following files (and file names):
README.md
Package.swift
io.github.AparokshaUI.AdwaitaTemplate.json
Sources/AdwaitaTemplate.swift
data/io.github.AparokshaUI.AdwaitaTemplate.metainfo.xml
data/io.github.AparokshaUI.AdwaitaTemplate.desktop
data/icons/io.github.AparokshaUI.AdwaitaTemplate.Source.svg
data/icons/io.github.AparokshaUI.AdwaitaTemplate.svg
data/icons/io.github.AparokshaUI.AdwaitaTemplate-symbolic.svg
- Edit the code. Help is available here, ask questions in the discussions.
- Edit the app's icons using the previously installed tools according to this tutorial.
- In GNOME Builder, click on the dropdown next to the hammer and then on
Export
. Wait until the file explorer appears, open the.flatpak
file and install the app on your device!
Flatpak SPM Generator
If you want to e.g. publish your app on Flathub and there is no internet connection allowed while running the build commands, you can use this tool that lets you generate a Flatpak manifest JSON from a Swift package.
Thanks
Dependencies
- Adwaita licensed under the GPL-3.0 license