alex

• [Release] start: new --target-path (-t) option to copy artifacts of a local release build (--local) to the specified directory. Artifacts are renamed by the pattern <name>_v<major>.<minor>.<patch>_<build>.<aab|ipa> (for example sundry_v0.1.2_3.ipa), where <name> is a project name from pubspec.yaml or the new build.name config option. The target directory should be outside of the repository or should be ignored by git, so artifacts can't get in the release commit; it's checked, as well as the write access, before the release is started.
• [Release] start: output directory of a local build is cleaned before the build, and after the build alex checks that exactly one artifact was created there. Now the release fails with an explanation instead of finishing successfully when the build produced no distribution file — for example, when an Xcode archive was created, but the export of an .ipa failed.

• [L10n] check_translations: new --print-changed-files flag to print the list of files changed after pub get (only paths, not their content). Off by default, so local runs are not flooded.
• [L10n] check_translations: new --fail-on-changed-files flag to fail with exit code 11 instead of printing a warning when some files were changed after pub get. Off by default; lets CI rely on the exit code instead of parsing the output.

• [Code] gen: in a pub workspace, run code generation once from the workspace root with the --workspace flag when the resolved build_runner version supports it (>= 2.11.0). Can be disabled via the new code.use_workspace config option (alex.yaml or the alex: section of pubspec.yaml).

• [L10n] check-translation: in verbose mode, print the list of changed files and the error details when the clean-status check fails after pub get, to make diagnosing dependency mismatches easier.

• [Feature] finish: new --squash (-s) flag to squash all feature commits into a single commit when merging into develop. Useful for tasks like golden tests updates.
• Fixed [L10n] from_xml: false-positive "No parameters found" error for one/two plural variants when the target locale legitimately omits the count parameter (e.g. Arabic "كل يوم" / "كل يومين"). Other plural quantities (zero, few, many, other) are still validated as before.

• [Feature] finish: append issue references as a markdown link ([#N](url/N)) when issue_url is set in alex config; falls back to the plain (#N) suffix otherwise.
• New command alex changelog update-issue-links (alias cl uil) — replaces plain (#N) issue references in CHANGELOG.md with markdown links built from issue_url. Reports an error if issue_url is not configured.
• New optional config option issue_url (in alex.yaml or the alex: section of pubspec.yaml).

• [Feature] finish: skip appending issue number suffix if the changelog line already contains a markdown link to the issue (e.g. [#1234](...)).

• New feature: Custom commands support! Define your own commands in alex_custom_commands.yaml to automate workflows.
  • Execute shell commands, alex commands, or Dart scripts
  • Support for command arguments (options and flags)
  • Variable substitution in actions using {{var}} or ${var} syntax
  • Commands management: alex custom list, add, show, edit, remove, check
  • Advanced actions for conditional logic and file operations:
    • check_git_branch - Check/switch git branch
    • check_git_clean - Verify no uncommitted changes
    • check_platform - Verify current OS (macos/linux/windows)
    • change_dir - Change working directory
    • check_file_exists - Verify file existence
    • copy_file - Copy files
    • rename_file - Rename files
    • move_file - Move files
    • create_file - Create files with content
    • create_dir - Create directories
    • delete_file - Delete files
    • delete_dir - Delete directories
    • rename_dir - Rename directories
    • replace_in_file - Replace text in files (with regex support)
    • append_to_file - Append content to files
    • prepend_to_file - Prepend content to files
    • print - Print messages to console
    • wait - Wait for specified duration (in milliseconds)
    • create_archive - Create ZIP/TAR.GZ archives
    • extract_archive - Extract archives
  • Verbose mode support with --verbose flag for detailed execution logs
  • See alex_custom_commands.yaml.example for examples

• [Code] code gen command supports run generation for subproject from root folder.

• Fixed: alex update command not working.
• Command alex update check replaced with alex update --check.

• [pubspec] get: Skip not valid pubspec files. Different result output when pubspec files are not found.
• README: added "Release" and "Update" sections. Improvements and fixes.

• New command alex update check to check if there are updates available for alex.

• New command alex update to update alex to the latest version.

[Pub] get:

• Added support for workspaces. See documentation.

Minimum SDK version is now 3.0.0.

[L10n]

• Auto adding @@locale to ARB files.

• Fixed: from_xml write @@locale at second place in ARB files, but extract at first.

[L10n] to_xml:

• Base XML file now formatted with 2 spaces indent.

[L10n] import_xml:

• Hint and more detailed log for skipped keys if they are not in the base file.

[L10n] check_translations:

• More cleaner output for problems with similar keys in different locales.
• Print number of checks and total checks for each check output.

• Fixed: Double log for intl commands.
• More cleaner output for l10n generate and some other commands.

• Fixed: Incorrect error message when there are uncommitted changes.

[L10n] check_translations (formerly check_translate):

• BREAKING CHANGE: Now it checks for all locales by default, not only en. You can specify locale with -l or --locale argument.
• Power up the command with additional checks:
  • Check if all strings from the localization file have translations in the specified locale (previous check, but with ability to check all locales).
  • Check if all strings from the localization file was sent for translation.
  • Check if all strings from base XML file have translation in XML for the specified locale.
  • Check if all strings from XML for the specified locale are imported to ARB for this locale.
  • Check if XML for the specified locale has redundant strings that are not in the localization file.
  • Check if there are not duplicated keys in XML for the specified locale.
  • Check if all code is generated for the specified locale.
• Ensure that GIT repository is clean before checking translations. Reset all changes after command execution.

[L10n] check_translations: returns exit code 10 if some checks failed. (broken, use 1.8.0+2).

[L10n] check_translations: returns exit code 10 if some checks failed.

[L10n] check_translations: prints changes if there are any in the repository before checking translations.

[L10n]

• New command l10n cleanup_xml to remove unused strings from XML files.

[L10n]

• import_xml: Added suggestion when importing archive file with wrong content.

[L10n]

• from_xml: Fail if there are duplicated keys in the imported file.

• Fail if there are warning during extraction to arb. Affects l10n extract, l10n check_translate, release start.

• [L10n] Fixed: empty output on failed extract command in some cases.

[L10n]

• import_xml: Fix error in the log message about total project locales count.
• from_xml: Handle new line symbols for json target.

• [L10n] from_xml added missing characters for validator checking.

[L10n] import_xml

• Support name of the directory without _diffs suffix. Therefore, now you can import directory with files like this: intl/intl_diffs_es.xml;
• Add warning when not all locales was imported.
• Fixed: invalid log about locale.
• Refactor of some console output.

• [L10n] generate always generate main messages file in the same order.

• [L10n] from_xml validates strings for Cyrillic and other inappropriate characters for locales, where Latin is required. Added config parameter require_latin (has default value).
• README: "Updating" section.

[L10n] import_xml:

• More relevant suggestion for --target value when failed to find appropriate file for import.
• Fixed: Invalid --diff flag name in suggestion (should be --diffs).

• Fixed: Program always have 0 exit code, even when execution failed.
• [L10n] from_xml:
  • Clearer and more detailed error message if there is no imported key in the base .strings file. Also added suggestions for fixes.
  • Refactor output strings: "export" replaced with more consistent in this context "import".

[L10n] import_xml:

• Detailed error explanation with a suggestion if can't find appropriate file for import.
• Fixed: null check error when imported file is incorrect.

• IMPORTANT [L10n] from_xml: Single quotes in the xml now escaped with another single quote for arb target. See documentation for details. Remove any manual escapes for ' from xml if you have any.
• Ignore pubspec.yaml from hidden folders (like .dart_tools/).
• Root pubspec.yaml is always the first.
• [L10n] import_xml: Prints total locales count in project at the end.
• [L10n] from_xml: Message on success for json target.

• Check for updates and message about a new version in the output.

• [L10n] import_xml: Support for --locale argument.
• [L10n] import_xml Fixed: Failed to import diff for not main localization files.
• [L10n] import_xml Fixed: Incorrect locations fallback (can change language, not only pick up region).

• [L10n] import_xml: Support for .zip from Google Play as a source (argument --path).
• [L10n] import_xml: Automatically detect diffs import for the translation from Google Play with suffix _diffs.
• [L10n] import_xml: Translations are imported in alphabetical order.

• Command to see a current version of alex: alex --version.

• [L10n] import_xml: Support for explicit diffs import (new argument --diffs).
• Readme: fixed "Generate XML for translation" section.

• [L10n] import_xml: Support for import files with suffix _diffs in plane directory structure (intl/intl_{locale}/intl_diffs.xml or intl_diffs/intl_diffs_{locale}/intl_diffs.xml);

• [L10n] to_xml: Export new lines as \n.
• [L10n] from_xml Fixed: Adds slash for \n on import.

• [Release] Local build now build for Android and iOS by default. See parameter --platforms.

• [Release] Small help fix.

• [L10n] to_xml:
  • Prints info about written diffs.
  • Do not create empty diff file.
• [L10n] import_xml:
  • Prints info about imported diffs.
  • Handle diff file with locale at the end.
  • Add documentation about import diffs.
• [L10n] Common prints improvements.

• [Release] Support for provide scrips to run before release.

• [Release] Parameter --entry-point to define the entry point for local build.

• Using ChatGPT to generate Release Notes (only en and ru locales). You should set global setting open_ai_api_key to use it.
• Added global settings. You can set it using new alex settings set command.

• Load config recursive by default.
• Fixed: broken release command with localization.
• Fixed: broken release command with configuration in subfolder.

• Support for configuring names for GIT branches.

• [Release] Added flag --local for local build.
• [Release] Added flag --skip_l10n to skip localization process when release.
• [Release] Added ci section in alex configuration. Ability to disable CI for project.

• [Release] Fixed: failed on empty commit attempt during local build.

• [Release] Automatically generate and commit translations after check before run release.

• Fix "CHANGELOG.md has unknown structure" error when run release start command.

• [L10n] Added check_translate command to check for translations for all locale strings.

• [Release] Automatically check translations for locale (en by default) before run release.