Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
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
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,9 @@ bin/cache/
engine_artifacts/
artifacts/

# Engine build workspaces (gclient sync output, lives outside repo by default)
engine/flutter*/workspace/

# Local engine source checkout for development (tracked in a separate repo)
flutter_upstream_tvos_engine/

Expand Down
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,6 +110,11 @@ match v1.0.1.
- `doc/` index gains "Porting an existing plugin" under "Plugin
development".

### Engine
- Updated to Flutter **3.44.0** (`559ffa3f75e7402d65a8def9c28389a9b2e6fe42`).
- Updated `bin/internal/engine.version` to `v1.0.0-flutter3.44.0`.
- Bumped `packages/flutter_tvos` to `1.0.5`.

## [1.0.1] — 2026-05-20

Patch release updating the pinned Flutter SDK and tvOS engine artifacts to Flutter 3.41.9.
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ A Flutter toolchain for building and running Flutter apps on **Apple TV (tvOS)**
## Current version

- flutter-tvos: `1.1.0`
- Flutter SDK: `3.41.9` (`00b0c91f06209d9e4a41f71b7a512d6eb3b9c694`)
- tvOS engine artifacts: `v1.0.0-flutter3.41.9`
- Flutter SDK: `3.44.0` (`559ffa3f75e7402d65a8def9c28389a9b2e6fe42`)
- tvOS engine artifacts: `v1.0.0-flutter3.44.0`

## Installation

Expand Down
2 changes: 1 addition & 1 deletion bin/internal/engine.version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v1.0.0-flutter3.41.9
v1.0.0-flutter3.44.0
2 changes: 1 addition & 1 deletion bin/internal/flutter.version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
00b0c91f06209d9e4a41f71b7a512d6eb3b9c694
559ffa3f75e7402d65a8def9c28389a9b2e6fe42
4 changes: 2 additions & 2 deletions doc/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Overview

`flutter-tvos` is a Dart CLI tool that acts as a Flutter tvOS custom embedder. It wraps an unmodified Flutter 3.41.9 SDK and injects tvOS-specific overrides via Flutter's dependency injection system (`runner.run()` with `overrides: <Type, Generator>{}`). It follows the same architectural pattern as flutter-tizen, flutter-elinux, and flutter-webos.
`flutter-tvos` is a Dart CLI tool that acts as a Flutter tvOS custom embedder. It wraps an unmodified Flutter 3.44.0 SDK and injects tvOS-specific overrides via Flutter's dependency injection system (`runner.run()` with `overrides: <Type, Generator>{}`). It follows the same architectural pattern as flutter-tizen, flutter-elinux, and flutter-webos.

The CLI is designed to feel identical to the standard `flutter` CLI for end users — the same commands (`build`, `run`, `devices`, `doctor`, `clean`) work as expected, with the platform layer swapped out for tvOS.

Expand Down Expand Up @@ -177,7 +177,7 @@ FFI plugins are not added to the plugin registrant — they are linked and loade

## Implementation Notes

- **Private fields in base classes** — `CachedArtifacts`, `FlutterBuildSystem`, and related Flutter 3.41.9 classes use private fields (`_fileSystem`, `_platform`). Subclasses must pass all named parameters directly to the `super()` constructor.
- **Private fields in base classes** — `CachedArtifacts`, `FlutterBuildSystem`, and related Flutter 3.44.0 classes use private fields (`_fileSystem`, `_platform`). Subclasses must pass all named parameters directly to the `super()` constructor.
- **`BuildMode` has no `.isDebug` getter** — compare explicitly: `buildMode == BuildMode.debug`.
- **`Generator` typedef** — imported from `package:flutter_tools/src/context_runner.dart`; this import is required in `executable.dart`.
- **Simulator builds require debug mode** — release and profile builds need `gen_snapshot` for AOT compilation, which targets a physical device.
Expand Down
2 changes: 1 addition & 1 deletion doc/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Run `flutter-tvos doctor` to check that all required components are in place. On
```
$ flutter-tvos doctor
Doctor summary (to see all details, run flutter-tvos doctor -v):
[✓] Flutter (Channel unknown, 3.41.9, on macOS, locale en-US)
[✓] Flutter (Channel unknown, 3.44.0, on macOS, locale en-US)
[✓] Xcode - develop for iOS and tvOS (Xcode 15.4)
[✓] Connected device (1 available)
```
Expand Down
12 changes: 12 additions & 0 deletions lib/commands/build.dart
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,23 @@ import '../tvos_plugins.dart';

class TvosBuildCommand extends BuildCommand {
TvosBuildCommand({
required super.artifacts,
required super.cache,
required super.fileSystem,
required super.flutterVersion,
required super.buildSystem,
required super.osUtils,
required Logger logger,
required super.androidSdk,
required super.config,
required super.platform,
required super.processUtils,
required super.processManager,
required super.fileSystemUtils,
required super.templateRenderer,
required super.terminal,
required super.plistParser,
required super.xcode,
required bool verboseHelp,
}) : super(logger: logger, verboseHelp: verboseHelp) {
addSubcommand(BuildTvosCommand(logger: logger, verboseHelp: verboseHelp));
Expand Down
12 changes: 12 additions & 0 deletions lib/executable.dart
Original file line number Diff line number Diff line change
Expand Up @@ -143,11 +143,23 @@ Future<void> main(List<String> args) async {
fileSystem: globals.fs,
),
TvosBuildCommand(
artifacts: globals.artifacts!,
cache: globals.cache,
fileSystem: globals.fs,
flutterVersion: globals.flutterVersion,
buildSystem: globals.buildSystem,
osUtils: globals.os,
logger: globals.logger,
androidSdk: globals.androidSdk,
config: globals.config,
platform: globals.platform,
processUtils: globals.processUtils,
processManager: globals.processManager,
fileSystemUtils: globals.fsUtils,
templateRenderer: globals.templateRenderer,
terminal: globals.terminal,
plistParser: globals.plistParser,
xcode: globals.xcode,
verboseHelp: verboseHelp,
),
TvosCleanCommand(verbose: verbose),
Expand Down
4 changes: 2 additions & 2 deletions lib/tvos_cache.dart
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ class TvosFlutterCache extends FlutterCache {
///
/// The GitHub Releases base URL can be overridden with the
/// `TVOS_ENGINE_BASE_URL` environment variable. The release tag comes from
/// `bin/internal/engine.version` (e.g. `v1.0.0-flutter3.41.9`).
/// `bin/internal/engine.version` (e.g. `v1.0.0-flutter3.44.0`).
class TvosEngineArtifacts extends EngineCachedArtifact {
TvosEngineArtifacts(
Cache cache, {
Expand Down Expand Up @@ -125,7 +125,7 @@ class TvosEngineArtifacts extends EngineCachedArtifact {
return versionFile.existsSync() ? versionFile.readAsStringSync().trim() : null;
}

/// The release tag, e.g. `v1.0.0-flutter3.41.9`.
/// The release tag, e.g. `v1.0.0-flutter3.44.0`.
String get releaseTag {
if (version == null || version!.isEmpty) {
throwToolExit(
Expand Down
4 changes: 4 additions & 0 deletions packages/flutter_tvos/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
## 1.0.5

- Updated compatibility with Flutter 3.44.0.

## 1.0.4

- Fixed `dart:ffi` and `dart:io` compile errors on Web. `flutter_tvos` can now
Expand Down
12 changes: 6 additions & 6 deletions packages/flutter_tvos/example/pubspec.lock
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@ packages:
path: ".."
relative: true
source: path
version: "1.0.4"
version: "1.0.5"
fuchsia_remote_debug_protocol:
dependency: transitive
description: flutter
Expand Down Expand Up @@ -157,10 +157,10 @@ packages:
dependency: transitive
description:
name: meta
sha256: "23f08335362185a5ea2ad3a4e597f1375e78bce8a040df5c600c8d3552ef2394"
sha256: "1741988757a65eb6b36abe716829688cf01910bbf91c34354ff7ec1c3de2b349"
url: "https://pub.dev"
source: hosted
version: "1.17.0"
version: "1.18.0"
path:
dependency: transitive
description:
Expand Down Expand Up @@ -242,10 +242,10 @@ packages:
dependency: transitive
description:
name: test_api
sha256: "8161c84903fd860b26bfdefb7963b3f0b68fee7adea0f59ef805ecca346f0c7a"
sha256: "949a932224383300f01be9221c39180316445ecb8e7547f70a41a35bf421fb9e"
url: "https://pub.dev"
source: hosted
version: "0.7.10"
version: "0.7.11"
vector_math:
dependency: transitive
description:
Expand All @@ -271,5 +271,5 @@ packages:
source: hosted
version: "3.1.0"
sdks:
dart: ">=3.9.0-0 <4.0.0"
dart: ">=3.10.0-0 <4.0.0"
flutter: ">=3.19.0"
Original file line number Diff line number Diff line change
Expand Up @@ -338,7 +338,7 @@
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
CLANG_ENABLE_MODULES = YES;
CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
DEVELOPMENT_TEAM = 866PPL96Z4;
DEVELOPMENT_TEAM = 2U7DD3DNRL;
FRAMEWORK_SEARCH_PATHS = (
"$(inherited)",
"$(PROJECT_DIR)/Flutter",
Expand Down Expand Up @@ -425,6 +425,7 @@
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
CLANG_ENABLE_MODULES = YES;
CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
DEVELOPMENT_TEAM = 2U7DD3DNRL;
FRAMEWORK_SEARCH_PATHS = (
"$(inherited)",
"$(PROJECT_DIR)/Flutter",
Expand Down Expand Up @@ -505,6 +506,7 @@
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
CLANG_ENABLE_MODULES = YES;
CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
DEVELOPMENT_TEAM = 2U7DD3DNRL;
FRAMEWORK_SEARCH_PATHS = (
"$(inherited)",
"$(PROJECT_DIR)/Flutter",
Expand Down
2 changes: 0 additions & 2 deletions packages/flutter_tvos/example/tvos/Runner/Info.plist
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,6 @@
<string>$(FLUTTER_BUILD_NAME)</string>
<key>CFBundleVersion</key>
<string>$(FLUTTER_BUILD_NUMBER)</string>
<key>UIMainStoryboardFile</key>
<string>Main</string>
<key>UIRequiredDeviceCapabilities</key>
<array>
<string>arm64</string>
Expand Down
2 changes: 1 addition & 1 deletion packages/flutter_tvos/pubspec.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
name: flutter_tvos
description: Platform detection and utilities for Flutter apps running on Apple TV (tvOS). Provides runtime checks for tvOS, device info, and capability queries.
version: 1.0.4
version: 1.0.5
homepage: https://fluttertv.dev
repository: https://github.com/fluttertv/flutter-tvos
issue_tracker: https://github.com/fluttertv/flutter-tvos/issues
Expand Down
Loading
Loading