[gjs: 10/12] build: Add Flatpak manifest




commit e24b76caa3ca66b0dc3984dc67fd649240ed4743
Author: Philip Chimento <philip chimento gmail com>
Date:   Sat Apr 3 18:12:09 2021 -0700

    build: Add Flatpak manifest
    
    Adding this manifest allows GNOME Builder to build GJS right out of the
    box, and run the interpreter and the tests using Builder's UI. This should
    help the onboarding process for new contributors.

 .gitlab-ci.yml                          |  2 +-
 .reuse/dep5                             |  2 +-
 build/flatpak/org.gnome.GjsConsole.json | 31 +++++++++++++++++++++++++++++++
 doc/Hacking.md                          | 11 +++++++++++
 4 files changed, 44 insertions(+), 2 deletions(-)
---
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index ae4cc6ed..77156de9 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -239,7 +239,7 @@ codespell:
     - .gjs-alpine
   stage: source_check
   script:
-    - codespell -S "*.png,*.po,*.jpg,.git,LICENSES" -f --builtin "code,usage,clear" 
--skip="./installed-tests/js/jasmine.js,./README.md,./subprojects/glib.wrap,./subprojects/gobject-introspection.wrap,./subprojects/sysprof.wrap"
 --ignore-words-list="afterall,befores,files',filetest,gir,inout,stdio,uint,upto,xdescribe"
+    - codespell -S "*.png,*.po,*.jpg,*.wrap,.git,LICENSES" -f --builtin "code,usage,clear" 
--skip="./installed-tests/js/jasmine.js,./README.md,./build/flatpak/*.json" 
--ignore-words-list="afterall,befores,files',filetest,gir,inout,stdio,uint,upto,xdescribe"
   except:
     - schedules
 
diff --git a/.reuse/dep5 b/.reuse/dep5
index 7c50dc32..e8cc3ec1 100644
--- a/.reuse/dep5
+++ b/.reuse/dep5
@@ -1,6 +1,6 @@
 Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 
-Files: .gitlab/issue_templates/*
+Files: .gitlab/issue_templates/* build/flatpak/org.gnome.*.json
     doc/* CONTRIBUTING.md NEWS *README* tools/heapgraph.md tools/yarn.lock
     installed-tests/js/modules/data.txt
 Copyright: No rights reserved
diff --git a/build/flatpak/org.gnome.GjsConsole.json b/build/flatpak/org.gnome.GjsConsole.json
new file mode 100644
index 00000000..5873cfc0
--- /dev/null
+++ b/build/flatpak/org.gnome.GjsConsole.json
@@ -0,0 +1,31 @@
+{
+  "comment": "----------------------------------------------------------------",
+  "comment": "This manifest is intended for a quick start with GJS using",
+  "comment": "GNOME Builder.",
+  "comment": "If you are planning to make contributions over a longer period",
+  "comment": "then consider following the setup guide in doc/Hacking.md.",
+  "comment": "----------------------------------------------------------------",
+  "app-id": "org.gnome.GjsConsole",
+  "runtime": "org.gnome.Platform",
+  "runtime-version": "master",
+  "sdk": "org.gnome.Sdk",
+  "command": "gjs-console",
+  "finish-args": [
+    "--socket=x11",
+    "--socket=wayland",
+    "--share=network",
+    "--filesystem=host"
+  ],
+  "modules": [
+    {
+      "name": "gjs",
+      "buildsystem": "meson",
+      "sources": [
+        {
+          "type": "git",
+          "url": "https://gitlab.gnome.org/GNOME/gjs.git";
+        }
+      ]
+    }
+  ]
+}
diff --git a/doc/Hacking.md b/doc/Hacking.md
index d00bfae3..0983ca14 100644
--- a/doc/Hacking.md
+++ b/doc/Hacking.md
@@ -1,5 +1,16 @@
 # Hacking on GJS #
 
+## Quick start ##
+
+If you are looking to get started quickly, then you can clone GJS using
+GNOME Builder and choose the `org.gnome.GjsConsole` build configuration.
+
+For the most part, you will be able to build GJS with the Build button
+and run the interpreter with the Run button.
+If you need to issue any of the Meson commands manually, make sure to do
+so in a runtime terminal (Ctrl+Alt+T) rather than a build terminal or a
+regular terminal.
+
 ## Setting up ##
 
 First of all, if you are contributing C++ code, install the handy git


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]