Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
9aa79f1
Stabilize GetX 5 RC runtime behavior and migration docs
mahanpyk Nov 3, 2026
6cf2922
Complete GetX RC app contracts and scoped lifetimes
mahanpyk Nov 3, 2026
fa46ca3
Stabilize browser transports and verify RC runtime gates
mahanpyk Nov 3, 2026
7d4afe1
Prepare GetX RC 9.4.0 for Flutter 3.47.9
mahanpyk Nov 4, 2026
ff18fec
Restore RC navigation history and validate iOS gestures
mahanpyk Nov 4, 2026
ad95083
Verify cold restoration history and deployed iOS probes
mahanpyk Nov 5, 2026
b97395e
Validate Android system and predictive back on emulators
mahanpyk Nov 5, 2026
0ac43b0
test: reproduce immutable default Rx collections
mahanpyk Nov 5, 2026
3f2faf1
fix: port mutable Rx collection defaults from master
mahanpyk Nov 5, 2026
d6026f6
test: reproduce context access outside GetRoot lifetime
mahanpyk Nov 5, 2026
7c7f03d
fix: port optional navigation contexts from master
mahanpyk Nov 5, 2026
3453814
Document GetX 5 release scope and master reconciliation
mahanpyk Nov 5, 2026
ebf29a1
Wait for native text input before cold-restoration setup
mahanpyk Nov 5, 2026
ff9c911
Prepare GetX 5 RC documentation and add Persian README
mahanpyk Nov 5, 2026
1637c1f
Complete matching English and Persian guides and update translated RE…
mahanpyk Nov 5, 2026
7e67c42
Correct outdated performance claims in translated guides
mahanpyk Nov 5, 2026
99ed4ef
test: reproduce stale page history and missing removal callback API
mahanpyk Nov 7, 2026
fbef1ab
fix: migrate page removal callbacks while preserving typed navigation…
mahanpyk Nov 7, 2026
7b01688
docs: document page removal migration and verify browser regressions
mahanpyk Nov 7, 2026
a6cfb5a
test: reproduce covered nested page overwriting browser probe state
mahanpyk Nov 7, 2026
567998e
fix: keep covered nested pages out of browser probe reports
mahanpyk Nov 7, 2026
7602cb2
style: align page removal callbacks with existing navigation code
mahanpyk Nov 7, 2026
d7eb443
Validate GetX 5 RC on Flutter 3.50.0
mahanpyk Nov 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
97 changes: 93 additions & 4 deletions .github/workflows/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,15 @@ name: build
# Trigger the workflow on push or pull request
on:
push:
branches: [master]
branches: [master, latest-getx5-RC, getx5-rc-stabilize]
pull_request:
branches: [master]
branches: [master, latest-getx5-RC]
workflow_dispatch:
inputs:
encoded_query:
description: Check the strict encoded-query browser gate
type: boolean
default: false
#A workflow run is made up of one or more jobs. Jobs run in parallel by default.
jobs:
test:
Expand All @@ -14,6 +20,10 @@ jobs:
run:
working-directory: ./
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
flutter: ["3.47.9", "3.50.0"]
#sequence of tasks called
steps:
# The branch or tag ref that triggered the workflow will be checked out.
Expand All @@ -23,12 +33,91 @@ jobs:
# https://github.com/marketplace/actions/flutter-action
- uses: subosito/flutter-action@v2
with:
flutter-version: "3.27.0"
flutter-version: ${{ matrix.flutter }}
channel: "stable"
- run: flutter pub get
#- run: flutter analyze
- run: flutter analyze --no-fatal-infos lib test
# run flutter widgets tests and unit tests
- run: flutter test --coverage
- run: >-
flutter test --platform chrome
test/documentation/public_imports_test.dart
test/rx/rx_workers_test.dart
test/rx/rx_collection_defaults_test.dart
test/regression/rc_page_removal_test.dart
test/regression/rc_navigator_removal_api_test.dart
- run: dart test/connect/support/run_browser_transport.dart
- run: dart test/connect/support/run_browser_transport.dart flutter --wasm
- run: flutter pub get
working-directory: example
- run: flutter analyze --no-fatal-infos lib test
working-directory: example
- run: flutter test
working-directory: example
- run: flutter pub get
working-directory: example_nav2
- run: flutter analyze --no-fatal-infos lib test
working-directory: example_nav2
- run: flutter test
working-directory: example_nav2
- run: flutter build web --no-pub
working-directory: example_nav2
- run: flutter build web --no-pub --wasm
working-directory: example_nav2
- run: flutter build web --no-pub --no-web-resources-cdn --no-wasm-dry-run -t lib/browser_navigation_probe.dart -o build/browser-js
working-directory: example_nav2
- run: node --experimental-websocket test/browser/navigation_smoke.mjs --build-dir build/browser-js --mode js --case ${{ matrix.flutter == '3.50.0' && 'all' || 'ordinary' }} --chrome /usr/bin/google-chrome --report build/browser-results/js.json
working-directory: example_nav2
- run: flutter build web --no-pub --no-web-resources-cdn --wasm -t lib/browser_navigation_probe.dart -o build/browser-wasm
working-directory: example_nav2
- run: node --experimental-websocket test/browser/navigation_smoke.mjs --build-dir build/browser-wasm --mode wasm --case ${{ matrix.flutter == '3.50.0' && 'all' || 'ordinary' }} --chrome /usr/bin/google-chrome --report build/browser-results/wasm.json
working-directory: example_nav2
- run: flutter build web --no-pub --no-web-resources-cdn --no-wasm-dry-run --dart-define=GETX_PROBE_RESTORATION=true -t lib/browser_navigation_probe.dart -o build/browser-history-js
working-directory: example_nav2
- run: node --experimental-websocket test/browser/navigation_smoke.mjs --build-dir build/browser-history-js --mode js --case history --chrome /usr/bin/google-chrome --report build/browser-results/history-js.json
working-directory: example_nav2
- run: flutter build web --no-pub --no-web-resources-cdn --wasm --dart-define=GETX_PROBE_RESTORATION=true -t lib/browser_navigation_probe.dart -o build/browser-history-wasm
working-directory: example_nav2
- run: node --experimental-websocket test/browser/navigation_smoke.mjs --build-dir build/browser-history-wasm --mode wasm --case history --chrome /usr/bin/google-chrome --report build/browser-results/history-wasm.json
working-directory: example_nav2
- name: Build the pure Flutter encoding control
if: ${{ matrix.flutter == '3.50.0' }}
run: flutter build web --no-pub --no-web-resources-cdn --no-wasm-dry-run -t test/browser/encoding_control.dart -o build/browser-control
working-directory: example_nav2
- name: Verify SDK URL encoding
if: ${{ matrix.flutter == '3.50.0' }}
run: node --experimental-websocket test/browser/navigation_smoke.mjs --build-dir build/browser-control --mode js --case encoded --chrome /usr/bin/google-chrome --report build/browser-results/control.json
working-directory: example_nav2
- name: Strict encoded-query diagnostics
if: ${{ matrix.flutter == '3.47.9' && github.event_name == 'workflow_dispatch' && inputs.encoded_query }}
run: node --experimental-websocket test/browser/navigation_smoke.mjs --build-dir build/browser-js --mode js --case encoded --chrome /usr/bin/google-chrome --report build/browser-results/encoded.json
working-directory: example_nav2
- uses: actions/upload-artifact@v4
if: always()
with:
name: browser-results-${{ matrix.flutter }}
path: example_nav2/build/browser-results/
# Upload coverage reports to Codecov
# https://github.com/marketplace/actions/codecov
- uses: codecov/codecov-action@v4

android:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-java@v4
with:
distribution: temurin
java-version: "17"
- uses: subosito/flutter-action@v2
with:
flutter-version: "3.50.0"
channel: stable
- run: flutter pub get
- run: flutter pub get
working-directory: example_nav2
- run: flutter build apk --debug --no-pub --target-platform android-arm64
working-directory: example_nav2
- name: Compile native Android acceptance harness
run: ./android/gradlew -p test/device/android assembleDebug assembleDebugAndroidTest
working-directory: example_nav2
102 changes: 102 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,105 @@
## [Unreleased]

The candidate below is prepared from `latest-getx5-RC`; it has not been
published. Version selection, tagging and package publication remain separate
release actions. See the [release scope](documentation/en_US/release_scope_5.md)
for master reconciliation, validation boundaries and deferred work.

## [5.0.0-release-candidate-9.4.1] - Unreleased candidate

- Add Flutter 3.50.0 / Dart 3.14.0 to CI while keeping the Flutter 3.47.9 /
Dart 3.13.7 minimum for existing consumers. The candidate still accepts the
Material and Cupertino types bundled with Flutter, deprecated in 3.50.
- Update the Navigator 2 Android example to AGP 9.1.1 and Kotlin 2.4.10.
- Verify encoded query values through browser refresh on Flutter 3.50.0. CI
checks the GetX probe in JS and WASM and runs an independent Flutter control.

## [5.0.0-release-candidate-9.4.0] - Previous candidate

### Compatibility and master reconciliation

- Require Flutter 3.47.9 and Dart 3.13.7, matching the selected stable SDK.
Continue using Flutter's bundled Material/Cupertino libraries; standalone
`material_ui` / `cupertino_ui` types are outside this candidate's scope.
- Port master's fresh mutable defaults for RxList, RxMap and RxSet while
preserving explicitly supplied backing collections.
- Return null from optional navigation context getters outside a mounted
GetX application's lifetime, matching master.

### Navigation, restoration and native acceptance

- Keep covered nested pages from overwriting browser acceptance probe reports
after navigating back to a visible root page.
- Migrate low-level GetNavigator and GetRouterOutlet.pickPages callback
arguments from `onPopPage` to `onDidRemovePage`. Configure back vetoes through
GetPage.canPop / PopScope and forward custom outlet notifications to the
owning delegate.
- Preserve typed native route results and remove the committed page's history
entry, including imperative replacement and covered-page removal; ignore
stale notifications for replaced pages with reused keys.
- Modernize the Navigator 2 example's Android host for the current Flutter
Gradle plugin and document the upstream web-history encoding limitation.
- Restore opt-in named-route history and supported arguments without losing
live navigation result futures; preserve numeric argument types in WASM.
- Migrate the iOS navigation example to Flutter's scene lifecycle and add
physical-device back, gesture and process-death restoration checks.
- Verify cold restoration before a fresh app mounts, check deployed probe
fingerprints, and test new typed navigation results after process recovery.
- Add Android emulator checks for system and predictive back, dynamic PopScope
vetoes, controller disposal and same-task process-death restoration.

### Runtime, transport and application contracts

- Complete browser HTTP timeout, abort and decoding-error futures and release
their event subscriptions.
- Send browser WebSocket text and binary values with the correct JS types;
close replaced connections and release heartbeat timers on disposal.
- Document queue cancellation and concurrent `futurize` completion ordering.
- Add real-browser HTTP, upload, socket and JS/WASM navigation checks, plus
local HTTPS/WSS certificate validation tests.
- Exclude generated machine-specific example files from the package inputs.
- Adapt app `routes` maps to Navigator 2 and report unsupported RouteFactory
callbacks explicitly. Preserve live theme, locale, routing and binding
ownership across ordinary app rebuilds.
- Honor shared binding lifetimes, current `autoRemove` settings and replacement
registrations; ignore asynchronous state completion after controller deletion.
- Dispose scroll resources and forward memory-pressure and accessibility events.
- Support typed HTTP modifiers and authenticators, replacement authentication
requests, response-body timeouts and IO WebSocket reconnection/disposal.
- Preserve snackbar completion and cleanup for queued cancellation, immediate
close, swipe dismissal and application teardown.
- Add safe `closeBottomSheet`, native Cupertino sheet transitions, nullable
routing observer support and current TickerMode frame settings.
- Restore Rx stream notifications after the last subscription is canceled and a
new subscription is created; make disposal safe during notification delivery.
- Prevent `onReady` after controller deletion, release locally owned bindings, and
correct `Bind.spawn` initialization and `Bind.put` cleanup.
- Recover queued jobs after errors while preserving stack traces, and make
collection assignment safe for aliased inputs.
- Handle synchronous `StateMixin.futurize` errors and ignore completion after
notifier disposal without duplicate status notifications.
- Complete displaced navigation results, honor middleware before replacing
history, preserve route configuration, and respect back-navigation vetoes.
- Correct selective overlay closing and snackbar overlay lookup.
- Support custom router configurations, forward app settings, and expose
restoration scopes in the app wrappers.
- Correct response modifier removal and keep asynchronous authentication retries
inside their error-handling scope.

### Documentation and migration

- Add RC-specific migration guidance, refresh translated documentation and
replace placeholder example tests with navigation and authentication scenarios.
- Add a Persian README with current GetX 5 examples; link it from every root
README and distinguish the source candidate from published packages.
- Expand the English and Persian READMEs into matching comprehensive guides
covering the same 32 topics and checked code examples, including RC changes.
- Integrate current async service, middleware, network, app configuration and
context recipes into translated README bodies; localize the RC changes and
repair their tables of contents and internal links.
- Add a branch-specific quick start and document compatibility, selective
master backports, explicit overlay closing and deferred SDK encoding work.

## [5.0.0-release-candidate-9.3.0]

- Support for Flutter 3.29.0
Expand Down
Loading