master..0bf9e91 · flathub

git.iko.soy/flathub

6 files changed+33−87

unifiedsplit

.github/pull_request_template.md−13 .github/workflows/external-data-checker.yml−12 .github/workflows/merge.yml−16 .github/workflows/stale.yml−15 CONTRIBUTING.md−15 README.md+33−16

.github/pull_request_template.mddeleted−13

@@ -1,13 +0,0 @@

1−### Please confirm your submission meets all the criteria

2−

3−- [ ] I have read the [App Requirements][reqs] and [App Maintenance][maint] pages.

4−- [ ] My pull request follows the instructions at [App Submission][submission].

5−- [ ] I am using only the minimal set of permissions. *(If not, please explain each non-standard permission.)*

6−- [ ] All assets referenced in the manifest are redistributable by any party. If not, the unredistributable parts are using an extra-data source type.

7−- [ ] I am an upstream contributor to the project. If not, I contacted upstream developers about submitting their software to Flathub. **Link:**

8−- [ ] I own the domain used in the application ID or the domain has a policy for delegating subdomains (e.g. GitHub, SourceForge).

9−- [ ] Any additional patches or files have been submitted to the upstream projects concerned. *(If not, explain why.)*

10−

11−[reqs]: https://github.com/flathub/flathub/wiki/App-Requirements

12−[maint]: https://github.com/flathub/flathub/wiki/App-Maintenance

13−[submission]: https://github.com/flathub/flathub/wiki/App-Submission

.github/workflows/external-data-checker.ymldeleted−12

@@ -1,12 +0,0 @@

1−name: 'Check if external data changed across Flathub org'

2−on:

3− schedule:

4− - cron: '0 * * * *'

5−

6−jobs:

7− flathub-data-checker-global:

8− runs-on: ubuntu-latest

9− steps:

10− - uses: flathub/actions/flathub-external-data-checker@master

11− env:

12− GITHUB_TOKEN: ${{ secrets.FLATHUBBOT_TOKEN }}

.github/workflows/merge.ymldeleted−16

@@ -1,16 +0,0 @@

1−name: Automatic application merge

2−

3−on:

4− issue_comment:

5− types:

6− - created

7−

8−jobs:

9− merge:

10− runs-on: ubuntu-latest

11− container:

12− image: ghcr.io/flathub/actions/merge:latest

13− steps:

14− - run: /entrypoint.py

15− env:

16− GITHUB_TOKEN: ${{ secrets.FLATHUBBOT_TOKEN }}

.github/workflows/stale.ymldeleted−15

@@ -1,15 +0,0 @@

1−name: "Close stale PR"

2−on:

3− schedule:

4− - cron: "0 0 * * *"

5−

6−jobs:

7− stale:

8− runs-on: ubuntu-latest

9− steps:

10− - uses: actions/stale@v1

11− with:

12− repo-token: ${{ secrets.FLATHUBBOT_TOKEN }}

13− stale-pr-message: "This PR hasn't received any updates in a year and will be automatically closed in 14 days. Feel free to re-open it if you plan to continue working on that pull request or think it deserves attention from Flathub admins"

14− days-before-stale: 365

15− days-before-close: 14

CONTRIBUTING.mddeleted−15

@@ -1,15 +0,0 @@

1−### Submitting a new package

2−

3−If you are submitting a new package please read the [app submission](https://github.com/flathub/flathub/wiki/App-Submission) and [app requirements](https://github.com/flathub/flathub/wiki/App-Requirements) pages in the wiki.

4−

5−Also double-check that your PR is against the `new-pr` branch.

6−

7−### Reporting a bug on a package

8−

9−Please open bugs for packages on their respective repositories you can search for them here: https://github.com/flathub

10−

11−### Requesting a new package

12−

13−Please do not open issues requesting packages. As long as a package meets the guidelines above and works it will be

14−generally be accepted. If you want to create a Flatpak see the [documentation](https://flatpak.readthedocs.io/en/latest/)

15−or join [#flatpak:matrix.org](https://matrix.to/#/#flatpak:matrix.org) for help.

README.md+33−16

@@ -1,27 +1,44 @@

1−# Flathub

1+Flathub

2+-------

3−Flathub is the central place for building and hosting Flatpak builds.

4+Flathub is the central place for building and hosting flatpak builds.

5−Using the Flathub repository

6−----------------------------

6+Building applications

7+---------------------

9+Application manifests should go in their own branches, named after the application ID.

10+

11+For example, for gnome-recipes, there is a branch named org.gnome.Recipes which has

12+the org.gnome.Recipes.json file at the toplevel.

713

8−To install applications that are hosted on Flathub, use the following:

14+The manifests should build releases, not development snapshots, so please use

15+tarballs or git tags, not just the tip of a branch.

16+

17+In case you build from a git tag, please specify both the tag name and the commit id, like so:

918```

10−flatpak remote-add flathub https://flathub.org/repo/flathub.flatpakrepo

11−flatpak install flathub org.gnome.Recipes

19+ "branch": "1.0.4",

20+ "commit": "cdfb19b90587bc0c44404fae30c139f9ec1cca5c"

1221```

22+This makes the build repeatable, since a tag can otherwise change its value over time.

23+You can also use only a commit, but specifying a tag name if there is one is good for readability.

24+

25+Flathub always builds in the flatpak branchname "stable", and it always passes --default-name=stable,

26+so you don't need to specify a branch key. But if you do (not recommended), it must be "stable".

1327

14−To install applications from the beta branch, use the following:

28+Flathub requires that you build against an sdk that is itself hosted on Flathub. The same goes for

29+sdk extensions that may be required to build your application. The easiest way to see what runtimes

30+are currently available is to install the flathub remote and use

1531```

16−flatpak remote-add flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo

17−flatpak install flathub-beta org.godotengine.Godot

32+flatpak remote-ls --runtime flathub

1833```

34+All applications in flathub should ship with appstream data.

1935

20−For more information and more applications see https://flathub.org

21−

22−Contributing to Flathub

23−-----------------------

36+Using the flathub repository

37+----------------------------

2438

25−For information on creating packages or reporting issues please see the [contributing page](/CONTRIBUTING.md).

39+To install applications that are hosted on flathub, use the following:

40+```

41+flatpak remote-add flathub http://flathub.org/repo/flathub.flatpakrepo

42+flatpak --user install flathub org.gnome.Recipes

43+```

2644

27−***Note:*** *this repository is not for reporting issues related to the flathub.org website itself or contributing to its development. For that, go to https://github.com/flathub/website*