Commit Graph

440 Commits

Author SHA1 Message Date
Matthew Leeds
4b002ebacd doc: Document --reinstall option
Closes: #1550
Approved by: alexlarsson
2018-04-04 14:55:14 +00:00
Matthew Leeds
148b0ca245 doc: Update old command names
The add-repo command was renamed to remote-add, and repo-update was
renamed to build-update-repo, so update the man pages.
2018-03-26 21:54:25 -07:00
Nicholas Bishop
ab117ee250 Add all missing declarations to flatpak-sections.txt
Closes: #1505
Approved by: mwleeds
2018-03-23 22:55:11 +00:00
Matthew Leeds
8103a95a7f doc: Update name of repo-contents command
The repo-contents command was renamed to remote-ls in flatpak 0.4.0, so
rename it in the man pages.

Closes: #1516
Approved by: mwleeds
2018-03-23 22:42:26 +00:00
Matthew Leeds
f4acf169f2 doc: Fix typo in command name
Closes: #1515
Approved by: mwleeds
2018-03-23 22:25:47 +00:00
Nicholas Bishop
69fa452bed Add FlatpakRelatedRef to API documentation
Closes: #1497
Approved by: alexlarsson
2018-03-19 09:41:09 +00:00
Alexander Larsson
f33fac310c Add fallback-x11 socket permission
This means use x11 if no alternative is present, and should be used
for applications that support both X11 and wayland, but want to be
sandboxed when running under a wayland compositor (but still want to
run under an X server).

Closes: #1416
Approved by: alexlarsson
2018-02-14 09:19:56 +00:00
Alexander Larsson
237b8ca9ff commit-from: Also copy/convert existing static deltas
When copying a commit, also bring forward any static deltas.
This is particularly interesting for flathub where we can
then generate static deltas on the build machines and then import
and sign it on the repo machine.

Closes: #1409
Approved by: alexlarsson
2018-02-13 14:30:50 +00:00
Matthew Leeds
94c6223045 doc: Add --timestamp option to build-export docs
Closes: #1408
Approved by: alexlarsson
2018-02-12 13:54:29 +00:00
Matthew Leeds
5ec98e788f search: Only update appstream data if it's old
Updating the appstream data on every invocation of the search command
involves a lot of overhead, so instead only update it if it's at least a
day out of date. This is consistent with how tools like dnf work.

Closes: #1352
Approved by: alexlarsson
2018-02-09 11:24:41 +00:00
Alexander Olofsson
3585651be7 Add semantic support for network installations
Closes: #1348
Approved by: alexlarsson
2018-02-06 09:19:34 +00:00
Matthew Leeds
32723a2b1d doc: Fix build-bundle docs
The build-bundle command takes a repository directory, not a build
directory.

Closes https://github.com/flatpak/flatpak/issues/1382

Closes: #1385
Approved by: alexlarsson
2018-02-06 09:10:42 +00:00
Matthew Leeds
3a14aef1d2 doc: Document -vv option
Closes: #1377
Approved by: alexlarsson
2018-02-05 15:58:29 +00:00
Matthew Leeds
3e143faf6a doc: Fix docs for --update-appstream
We no longer run appstream-builder (see commit 455d3a7b2) so update the
documentation for the --update-appstream option.

Closes: #1360
Approved by: alexlarsson
2018-02-05 15:29:34 +00:00
Matthew Leeds
aabd44fb8a doc: Fix refentry id in flatpak-build-sign.xml
The id value in flatpak-build-sign.xml is "flatpak-build-export", which
causes the generated HTML to link to that command instead. Fix it.
2018-01-30 23:34:10 -08:00
Alexander Larsson
659b02011a install: Support local paths/uris
If the remote is a local path (absolute or relative starting with ./)
then we convert this to a file: uri, which are now supported to
install directly from a local repo.

This is very useful when testing locally built apps.

Closes: #1244
Approved by: alexlarsson
2017-12-14 09:27:22 +00:00
Alexander Larsson
97683cfbe1 override: Support global overrides
This lets you add overrides that affect all applications. Application
overrides have higher priority so will override the global overrides.

Closes: #1245
Approved by: alexlarsson
2017-12-14 08:49:23 +00:00
Alexander Larsson
e769cdd489 update: Update apps from both system and user installations
Unless you manually specify an installation it looks for updates
in all the standard installations.

This fixes https://github.com/flatpak/flatpak/issues/282

Closes: #1246
Approved by: alexlarsson
2017-12-13 10:03:47 +00:00
Matthew Leeds
b3828eea46 app: Make remote commands smarter wrt installations
Currently "flatpak remotes" shows remotes across user and system
installations, but other remote commands (remote-delete, remote-modify,
remote-ls, remote-info) only work on one installation: the system one
unless overridden using --user or --installation. This commit changes
each command to infer the correct installation by checking which has
the specified remote. In case multiple installations have remotes by
the same name, the user is prompted to decide which to use.

This commit also adds unit tests and updates the man pages for the
aforementioned commands.

Fixes https://github.com/flatpak/flatpak/issues/787

Closes: #1205
Approved by: alexlarsson
2017-12-12 15:26:41 +00:00
Matthew Leeds
27fcf108fd doc: Add missing commands to flatpak-docs.xml.in
This adds some recently added commands to flatpak-docs.xml.in so they
will be included in the generated HTML command reference.
2017-12-11 16:19:12 +01:00
Matthew Leeds
32161146a0 doc: Sort flatpak-docs includes alphabetically
Sort the list of manpages we're including in flatpak-docs.xml.in, to
make it easier to maintain.
2017-12-11 16:19:12 +01:00
Matthew Leeds
4f1af61d06 docs: Document remote-ls without REMOTE
The "flatpak remote-ls" command can be used without specifying a remote,
so change the man page and --help output to reflect that.

Closes: #1210
Approved by: alexlarsson
2017-11-27 08:19:51 +00:00
Matthew Leeds
d9061fa276 search: Support --installation=NAME option
The other commands that support --user and --system allow you to specify
an installation using --installation, so this makes search consistent
with that.

Closes: #1185
Approved by: TingPing
2017-11-22 06:36:37 +00:00
Matthew Leeds
817da55d38 docs: Fix grammar in remote-info man page
Closes: #1184
Approved by: mwleeds
2017-11-21 17:34:34 +00:00
Alexander Larsson
0a9ae464f6 Add remote-info command
This shows information about a ref in a remote. Of particular interest
is the --log option which gives you a history which can be used
with update --commit=XXX to roll back an update.

Closes: #1174
Approved by: alexlarsson
2017-11-21 11:16:06 +00:00
Alexander Larsson
12e68e7cec Add --readonly switch to flatpak build
This makes /app (or other destinations) read-only, which will be
later used by flatpak-builder when running tests, that should not
affect the build.

Closes: #1172
Approved by: alexlarsson
2017-11-16 16:13:48 +00:00
Matthew Leeds
d725d83585 docs: Fix ref in remote-ls manpage
The remote-list command was renamed to remotes, so change it in the
manpage and make it a link.

Closes: #1179
Approved by: alexlarsson
2017-11-16 12:53:10 +00:00
Matthew Leeds
b73e8476a7 docs: Fix a few mistakes
Some of these are grammatical errors, and some are mistakes caused by
copying phrases from the flatpak-install manpage.

Closes: #1177
Approved by: alexlarsson
2017-11-16 08:00:05 +00:00
Matthew Leeds
a218bdb282 docs: Document "flatpak update --appstream" better
The manpage description for flatpak-update's --appstream option says it
updates appstream data for the remote, but it's unclear that the remote
should be passed on the command line instead of a ref. This commit
updates the manpage to document that form of the command.

Closes: #1177
Approved by: alexlarsson
2017-11-16 08:00:05 +00:00
Patrick Griffis
61daf53674 docs: Add flatpak-search man page
Closes: #1176
Approved by: mwleeds
2017-11-16 07:26:28 +00:00
Matthew Leeds
c15d29f9d0 docs: Fix typo 2017-11-15 21:28:54 -08:00
Alexander Larsson
105f00b918 Update appstream data on "flatpak update" (#1169)
* Update appstream data on "flatpak update"

This is especially useful since we now have flatpak search which uses
this data.

* fixup! Update appstream data on "flatpak update"
2017-11-15 21:23:55 -08:00
Matthew Leeds
61d1c69836 docs: Fix broken references
These commands were renamed a while back.

Closes: #1167
Approved by: alexlarsson
2017-11-14 12:04:59 +00:00
Alexander Larsson
a6f65d3b7c Add --log-*-bus to flatpak build
Closes: #1160
Approved by: alexlarsson
2017-11-14 11:57:30 +00:00
Alexander Larsson
9e1e982bf8 Add flatpak config option
This is currenly only used to configure the languages to install.

Closes: #1098
Approved by: alexlarsson
2017-10-11 12:48:07 +00:00
Alexander Larsson
140fee3adf build-finish: Add --extension-priority option (#1084)
* build-finish: Add --extension-priority option

This lets you set the priority of the extension.

* fixup! build-finish: Add --extension-priority option

* fixup! build-finish: Add --extension-priority option
2017-10-06 09:01:18 -07:00
Alexander Larsson
440389bc8e Add locale-subset property of extensions to match *.Locale behaviour
This way other types of extensions can also be subset by locale.
For instance, documentation.
2017-09-21 16:39:53 +02:00
Simon McVittie
2496dbb336 flatpak-metadata(5): Document when each field was introduced
This is useful for Flatpak runtime and app authors who want to know
which features they can use when targeting a particular branch,
or if they do not have a particular branch in mind, what value they
should put in the required-flatpak field.

Signed-off-by: Simon McVittie <smcv@collabora.com>
2017-09-20 09:11:07 +02:00
Alexander Larsson
7eece97d3c build: Add --with-appdir
If specified, this exposes the ~/.var/app/$appid to the build
sandbox. Useful when testing uninstalled builds.
2017-09-19 11:52:27 +02:00
Alexander Larsson
75d7e76276 build: Add --die-with-parent option and drop it by default
We no longer use bwrap --die-with-parent by default, because it has
problems due to the semantics of PR_SET_PDEATHSIG. In particular, it
will kill bwrap as soon as *any* thread in the parent exits, not just
the main one.

This caused weird problems in gnome-builder, as seen in:
 https://bugzilla.gnome.org/show_bug.cgi?id=783950#c14

It should be safe to use this from single-threaded apps though,
so flatpak-builder can still use it. It just has to explicitly
enable it.
2017-08-30 11:21:28 +02:00
Alexander Larsson
52bd146561 Remove flatpak-builder from flatpak repo
This is now in a separate flatpak-builder repo
2017-08-25 11:10:50 +02:00
Alexander Larsson
c6ef29c06b builder: Add support for defining extensions in flatpak-builder
This takes a list of properties and generate finish arguments.
Additionally you can specify "bundle": true, which causes f-b to emit
an actual extension implementation, similar to e.g. the locale
and debuginfo extension.
2017-08-21 15:46:06 +02:00
Alexander Larsson
37fa3461c9 builder: Add --delete-build-dirs
This makes sure we always delete build dirs, even if there
was a build failure. This is useful for automatic build systems
like flathub or continuous integration.

This fixes https://github.com/flatpak/flatpak/issues/646
2017-08-18 16:29:17 +02:00
Philip Withnall
e5e52b4b79 common/utils: Allow collection-id to be updated from repo config
In order to provide a transition path for repositories to add collection
IDs to themselves and propagate those collection IDs to clients’ remote
configurations, add another repo config key which controls whether the
repository’s collection ID is published. If xa.collection-id is set in
the repo’s published metadata, the client will update its configuration
to the given ID — but only if no ID is set already. This is a one-time
transition to prevent malicious repositories from remotely changing the
user’s configuration to associate their remote with a well-known
collection ID they don’t own.

Add a test for this.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
2017-08-18 14:23:03 +02:00
Philip Withnall
c4819af5a0 common: Support collection IDs for related refs and extensions
Add support for collection IDs to the code which finds and pulls
related refs and other extensions.

Currently, related refs must have the same collection ID as the parent
ref — this is the most likely scenario anyway. In future, it should be
possible to extend the code to support pulling related refs from other
collections.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
2017-08-18 14:23:03 +02:00
Philip Withnall
024d835460 common: Support unsigned summary files and separate repo metadata
In order to eliminate some race conditions around updating the
summary{,.sig} file on the server, and to decouple signing the summary
from signing commits, and to support peer to peer mirrors of content
from multiple upstream collections: add support for unsigned summary
files.

This relaxes the requirement for gpg-verify-summary=true iff
collection-id is set in a remote’s local configuration. It depends on
some pending libostree changes to verify the ref for each commit using
the commit’s signed metadata. See
https://github.com/ostreedev/ostree/issues/983.

Metadata storage has moved from the summary file to a new
ostree-metadata well-known branch on each repository, since this can be
signed for each update and for each collection separately. If the
collection-id is set in a remote’s local configuration, flatpak will
retrieve all repository metadata from this branch rather than from the
summary file. If collection-id is unset, it will ignore this branch and
continue to use the summary file, which will continue to be updated (and
externally signed as summary.sig) for backwards compatibility.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
2017-08-18 14:23:03 +02:00
Philip Withnall
ae7d960372 common: Support collection IDs in flatpak{ref,repo} and bundle files
These are loaded from the ref/repo/bundle metadata and added to the new
remote configuration.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
2017-08-18 14:23:03 +02:00
Philip Withnall
5b002edf06 builder: Add collection ID support to the flatpak builder
Pass a --collection-id argument through to `flatpak build-export`.

Also add a ‘collection-id’ property to manifest files, which can be used
to set the collection ID on an exported repo (when using --repo) without
having to provide a command line option.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
2017-08-18 14:23:03 +02:00
Philip Withnall
f3c898da05 app: Add support for collection IDs to built-in flatpak commands
This sets the collection ID on remote configs and in commit metadata
when building flatpaks.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
2017-08-18 14:23:03 +02:00
Alexander Larsson
f9a06a0fcd builder: Add --install-deps-from=REMOTE
This allows you to automatically install/update dependencies required
by the manifest. The dependencies include:
 Runtime, Sdk, Base, Sdk Extensions and Platform Extensions

There is also a --install-deps-only switch to make the build
stop after the dependencies are installed.

Fixes https://github.com/flatpak/flatpak/issues/955
2017-08-18 11:04:13 +02:00