The Qt Installer Framework provides a set of tools and utilities to create
installers for the supported desktop Qt platforms: Linux, Microsoft Windows, and
macOS.


Documentation
--------------------------

The binary packages for the Qt Installer Framework include documentation in the
doc directory. The documentation is also available online at
    https://doc.qt.io/qtinstallerframework/index.html

Notes
--------------------------

To build an installer, it is advised to use a statically linked Qt (6.6.0 or
newer). The tested and supported Qt version is 6.7.2

See the documentation at
    https://doc.qt.io/qtinstallerframework/ifw-getting-started.html

Changes / Additions in this tree
--------------------------

This checkout includes several local enhancements (see source under src/sdk_acnas):

- GitLab authentication UI
  - Added a GitLab login page (src/sdk_acnas/gitlablogin.cpp / .h) that supports:
    - Username/password entry with optional "remember credentials".
    - Secure storage of saved credentials (uses CryptoHelper encryption helpers).
    - UI integration for showing connection/login progress.

- Repository download support (GUI + CLI)
  - A Download Repository action was added to the installer UI. The download control shows
    progress, success and error states; the implementation details are internal to the UI code.
  - Command-line integration was added in src/sdk_acnas/commandlineinterface.cpp:
    - --glu / --gitlab-user <name>    : provide GitLab username
    - --glp / --gitlab-password <pwd>  : provide GitLab password
    - --dlr / --download-repo          : download GitLab repository after authentication
  - Examples:
      ./installer --glu myuser --glp mypass --dlr
      ./installer --glu myuser --glp mypass    (authenticate only)

UI progress controls
- The installer UI uses controls that indicate operation progress and final state (success/error).

Notes for integrators and maintainers
--------------------------
- The GUI and CLI changes are intentionally minimal and keep existing UI layout.
- If you use custom QSS that targets widget names or properties, check selectors used in your theme.
- The command-line download path defaults to:
    <application-dir>/repository
- Ensure the application is built with the same Qt version recommended above.

Installer variables (used by installer scripts)
--------------------------
The installer supports a small set of values that can be set from control scripts
or passed into the installer environment via installer.setValue(...). These are
used by the GitLab login and repository download features:

- GitLabUrl
  - Purpose: full GitLab API / packages URL used to locate and download the package repository.
  - Set this value in your installer controller script (controller.js) for each build.
  - NOTE: Set this value in controller.js for your build.

- GitLabToken
  - Purpose: token identifier or name used when requesting a user token from the server.
  - NOTE: Set this value in controller.js for your build.

- GitLabTimeout
  - Purpose: request timeout in milliseconds for GitLab API calls (token exchange, downloads).
  - NOTE: Set this value in controller.js for your build.

Notes:
- GitLabUrl must point to the API/package endpoint or a URL that the downloader/parser can derive API + package/version from.
- GitLabToken is the token name configured on the server side; the actual user token is obtained at runtime and stored under "GitLabUserToken".
- GitLabTimeout is optional; leave unset to use defaults, or set an integer (milliseconds) to override network timeouts.

Getting Help
--------------------------

If you think you found a bug, please report it to

https://bugreports.qt.io/browse/QTIFW

General questions are best asked on interest@qt-project.org.