aparoksha/adwaita-template
Template
1
1
Fork 0
Code Issues 2 Pull Requests Activity
A template application repository for the Adwaita for Swift framework
12 Commits 1 Branch 0 Tags 106 KiB
Swift 93.4%
Dockerfile 6.6%
473ad65dde
Go to file Use this template
david-swift 473ad65dde
Update Adwaita license
2024-03-07 21:16:04 +01:00
data Initial Commit 2023-11-26 22:19:52 +01:00
Sources Mark menu as primary and add tooltip 2024-03-05 17:03:33 +01:00
.gitignore Initial Commit 2023-11-26 22:19:52 +01:00
io.github.AparokshaUI.AdwaitaTemplate.json Remove useless code in Flatpak manifest 2024-03-04 07:15:14 +01:00
LICENSE.md Initial Commit 2023-11-26 22:19:52 +01:00
Package.swift Add localization 2024-03-04 21:23:38 +01:00
README.md Update Adwaita license 2024-03-07 21:16:04 +01:00

README.md

Adwaita Template Icon

Adwaita Template

Adwaita Template is a template application for the Adwaita package.

Table of Contents

Installation

Install the Swift 5 Freedesktop SDK Extension

  1. Install flatpak.
  2. Add Flathub to Flatpak:
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  1. Install the newest version of the Freedesktop SDK:
flatpak install flathub org.freedesktop.Sdk
  1. Install the LLVM 16 Freedesktop extension:
flatpak install flathub org.freedesktop.Sdk.Extension.llvm16/x86_64/23.08
  1. 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
  1. 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

  1. 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
  1. Build and run the application.
  2. 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
  3. Edit the code. Help is available here, ask questions in the discussions.
  4. Edit the app's icons using the previously installed tools according to this tutorial.
  5. 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