Release 0.5.5
Overview
AGS CLI 0.5.5 is a patch release on top of 0.5.4. Each item below is tagged with the area it affects: [General], [Extend], or [AMS].
Existing scripts and workflows keep working without changes. To upgrade from 0.5.1 or later, run ags update --install.
Highlights
[General] Manage namespace configuration with ags namespace-config
ags namespace-config manages the namespace configuration that AGS stores for your game. It has five resources:
configs: config values, such asCORS.account-profiles: account profile configs.email-senders: email senders and their domain authentication.email-api-keys: email API key accounts.email-templates: email templates.
This service is separate from ags config, which holds the settings of the CLI itself.
ags namespace-config configs update replaces the stored value and does not merge it. Send the complete value. For CORS, include every field that you want to keep. A field that you leave out takes the value of the parent namespace, or is removed.
[General] A workflow can ask for a folder
A file_picker input in a workflow can set kind: directory to choose a folder instead of a file. The picker then shows only folders, and a Select this folder row selects the folder that you are in.
inputs:
- name: buildPath
description: Pick the build output directory
required: true
schema: {type: string}
file_picker:
kind: directory
The default kind is file, so existing workflows do not change. ags workflow add rejects a file_picker that sets both extensions and kind: directory, because extensions apply only to files.
The workflow protocol version is now 1.1.0. On 0.5.5, a workflow that declares 1.0.0 still runs unchanged, and ags workflow run prints a note about the version difference until the file declares 1.1.0. AGS CLI 0.5.4 and earlier run a workflow that declares 1.1.0 and print the same note. They ignore kind: directory, so their picker selects files. See Workflows.
Improvements
- [General] The starter file from
ags workflow templatenow shows a local-action step (kind: localwithaction:) and lists the available actions. It also shows a fixed-choice (enum) input, and listsform_datawith the other field locations. - [General] The
--helpofags iam clients create,ags iam clients update, andags iam clients bulk-updatenow explainsbaseUri. The value identifies the client as a token recipient for audience (aud) checks. It has no effect on redirect URIs or CORS.
Bug fixes
- [General] The welcome hint on the first run no longer tells you to run
ags auth loginwhen you are already signed in. This includes an expired session that refreshes on the next call. The hint also leaves out that line when the command is itself anags authcommand. - [Extend]
ags extend database-tunnelnow stops on the first Ctrl-C, even when you press it right after the tunnel starts to listen. Before, a Ctrl-C at that moment could be missed, and the tunnel continued until a second Ctrl-C. The old name,ags extend tunnel, has the same fix. - [AMS]
ags ams uploadno longer fails a large upload because it takes more than two minutes. An upload now continues while data moves, and stops only when no data moves for 120 seconds. The error then says that no data moved. A storage error at the end of a long transfer is now retried, as it is at the start of the transfer.
Full release notes
See the 0.5.5 release on GitHub for the complete list of changes.