ruflet 0.0.22 → 0.0.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a925aef31bb20fe4f6f48f2d6f68e1f0bc1599fd494a517c2412c524c535e6c8
-  data.tar.gz: ddd86413840811bb99b66dbb5f9e325a338e981bcc1a126b4b73e46ec06a63fb
+  metadata.gz: bb526fe95e57e72ddf182e86be54239b05a6f782a0f574780aa6fabca3a69ef6
+  data.tar.gz: fd8a42692977eb964011e2d087e838345e9d836dca2f6d11f7560197b9cae562
 SHA512:
-  metadata.gz: 8fb021bc622f6ea04a0a6f444bae379546cc790b9349b0dea81c5d8d25926275cc9102ec9c05d08fb993f4b2ed749e7b4e502dfa35cad1551d5df74e81bc3859
-  data.tar.gz: 4124df68e4b93d77af36a7132bc1a59a88764c02cb1e875e3c84bd76e763f805e4381be292b1727ea9f1cd53103c9f73c1a86da01d9817fe45e2363460b4f2dd
+  metadata.gz: d2b0ef3741d51fe6cdba91d41db6fd5dba388974dedcd00751981ee89a399bfad1f0d07e9b8d7c32e512f80fd652ee784fcda80d71105f70fad323e63e7876c0
+  data.tar.gz: cfe6ec3fe141f6edc414e866d204bc7831cbc1aa8fed27d82cae43a84b20df6e78e56819bd7341818025a3f1ed4dc63322b46014cccb8007acffae090e0ec14e

data/README.md

@@ -25,21 +25,16 @@ dependencies. Run Ruflet commands directly inside the generated project.
 
 ```bash
 ruflet new <appname>
-ruflet run [scriptname|path] [--web|--desktop] [--experimental|--exp] [--port PORT]
+ruflet run [scriptname|path] [--web|--desktop] [--port PORT]
 ruflet debug [scriptname|path]
 ruflet devices
 ruflet emulators
 ruflet doctor [--fix]
 ruflet update [web|desktop|all] [--check] [--force]
-ruflet build <apk|android|ios|ipa|aab|web|macos|windows|linux> [--lite|--full|--self] [--experimental|--exp]
+ruflet build <apk|android|ios|ipa|aab|web|macos|windows|linux> [--lite|--full|--self]
 ruflet install [--device DEVICE_ID]
 ```
 
-`--experimental` is available only for iOS and macOS builds. It selects the
-native Apple renderer while the normal Ruflet build pipeline continues to
-resolve the declared services, extensions, permissions, assets, and runtime
-mode. Without it, Apple builds use only the Flutter renderer.
-
 `--lite` creates the compact self-contained build: project Ruby is precompiled
 when the matching mruby compiler is available, and the bundled VM starts in
 parallel with Flutter. `--self` remains an alias for this profile.
@@ -53,15 +48,11 @@ a target-specific CRuby runtime. Set `RUFLET_FULL_RUNTIME_PATH`, or
 Ruflet refuses to substitute the lite mruby engine for a requested full build.
 
 Before Flutter resolves or bundles packages, Ruflet removes extension plugins
-that are not selected by the current services/extensions configuration. With
-the experimental Apple renderer, built-in declarations are registered as Swift
-extensions and their duplicate Dart/Flutter plugins are excluded entirely.
-
-On macOS, `ruflet run --experimental` (or `ruflet run --exp`) downloads the
-experimental Ruflet Explorer iOS Simulator prebuild the first time, reuses its
-versioned cache afterward, and launches it on the already-booted simulator
-with the current backend URL. Add `--desktop` to download and launch the native
-macOS prebuild instead: `ruflet run --desktop --exp`.
+that are not selected by the current services/extensions configuration.
+
+`ruflet run --desktop` downloads the Ruflet Explorer prebuild for the host the
+first time, reuses its versioned cache afterward, and launches it with the
+current backend URL.
 
 Commands that create, diagnose, or build a Flutter client compare the cached
 template revision with `AdamMusa/ruflet-template` on GitHub. When `main`

data/lib/ruflet/cli/build_command.rb

@@ -35,30 +35,6 @@ module Ruflet
         "video" => { package: "ruflet_video", alias: "ruflet_video" },
         "webview" => { package: "ruflet_webview", alias: "ruflet_webview" }
       }.freeze
-      # Native Swift products matching the Ruflet extensions selected by the
-      # ordinary Ruflet build configuration. The same resolved extension keys
-      # drive Dart imports, Swift imports/registration, and Xcode linkage.
-      NATIVE_APPLE_EXTENSION_MAP = {
-        "ads" => { module: "RufletAds", initializer: "RufletAds.Extension()" },
-        "audio" => { module: "RufletAudio", initializer: "RufletAudioExtension()" },
-        "audio_recorder" => { module: "RufletAudioRecorder", initializer: "RufletAudioRecorderExtension()" },
-        "camera" => { module: "RufletCamera", initializer: "RufletCameraExtension()" },
-        "charts" => { module: "RufletCharts", initializer: "RufletChartsExtension()" },
-        "code_editor" => { module: "RufletCodeEditor", initializer: "RufletCodeEditorExtension()" },
-        "color_pickers" => { module: "RufletColorPickers", initializer: "RufletColorPickersExtension()" },
-        "datatable2" => { module: "RufletDataTable2", initializer: "RufletDataTable2Extension()" },
-        "flashlight" => { module: "RufletFlashlight", initializer: "RufletFlashlightExtension()" },
-        "geolocator" => { module: "RufletGeolocator", initializer: "RufletGeolocatorExtension()" },
-        "lottie" => { module: "RufletLottie", initializer: "RufletLottieExtension()" },
-        "map" => { module: "RufletMap", initializer: "RufletMap.Extension()" },
-        "permission_handler" => { module: "RufletPermissionHandler", initializer: "RufletPermissionHandlerExtension()" },
-        "qrcode_scanner" => { module: "RufletQRScanner", initializer: "RufletQRScannerExtension()" },
-        "rive" => { module: "RufletRive", initializer: "RufletRiveExtension()" },
-        "secure_storage" => { module: "RufletSecureStorage", initializer: "RufletSecureStorageExtension()" },
-        "spinkit" => { module: "RufletSpinKit", initializer: "RufletSpinKitExtension()" },
-        "video" => { module: "RufletVideo", initializer: "RufletVideoExtension()" },
-        "webview" => { module: "RufletWebView", initializer: "RufletWebViewExtension()" }
-      }.freeze
       PROTECTED_SERVICE_EXTENSIONS = {
         "camera" => %w[camera permission_handler],
         "microphone" => %w[audio_recorder permission_handler],
@@ -152,18 +128,10 @@ module Ruflet
         runtime_profile = full ? :full : :lite
         @ruflet_runtime_profile = self_contained ? runtime_profile : :server
         @ruflet_runtime_profile_explicit = !!(lite || full)
-        experimental = args.delete("--experimental")
-        experimental_alias = args.delete("--exp")
-        experimental ||= experimental_alias
         verbose = args.delete("--verbose") || args.delete("-v")
         platform = (args.shift || "").downcase
         if platform.empty?
-          warn "Usage: ruflet build <apk|android|aab|ios|ipa|web|macos|windows|linux> [--lite|--full|--self] [--experimental|--exp] [--verbose]"
-          return 1
-        end
-
-        if experimental && !%w[ios ipa macos].include?(platform)
-          warn "build config error: --experimental is supported only for ios and macos"
+          warn "Usage: ruflet build <apk|android|aab|ios|ipa|web|macos|windows|linux> [--lite|--full|--self] [--verbose]"
           return 1
         end
 
@@ -178,7 +146,6 @@ module Ruflet
         requested_platform = platform
         platform = "ios" if platform == "ipa"
         @ruflet_build_platform = platform
-        @ruflet_experimental_native_renderer = !!experimental
 
         # The embedded Ruby VM is a native plugin with no browser
         # implementation, so a self-contained web build produces an app that
@@ -198,9 +165,8 @@ module Ruflet
           return 1
         end
 
-        renderer = experimental ? ", experimental native renderer" : ""
         mode = self_contained ? "self-contained #{runtime_profile}" : "server-driven"
-        build_note("Preparing #{platform} build (#{mode}#{renderer})")
+        build_note("Preparing #{platform} build (#{mode})")
         config = load_ruflet_config
         if runtime_profile == :full && self_contained
           return 1 unless configure_full_runtime_distribution(config, platform, verbose: !!verbose)
@@ -230,6 +196,9 @@ module Ruflet
           if @ruflet_runtime_profile_explicit
             build_args += ["--dart-define", "RUFLET_RUNTIME_PROFILE=#{runtime_profile}"]
           end
+          # The platform layer starts the VM before Flutter exists, so the app
+          # bundle -- not a Dart define -- has to carry the same decision.
+          configure_platform_autostart(client_dir, platform, verbose: !!verbose)
         elsif backend_url
           build_args += ["--dart-define", "RUFLET_BACKEND_URL=#{backend_url}"]
         elsif RUNTIME_RESOLVED_BACKEND_PLATFORMS.include?(platform)
@@ -243,9 +212,6 @@ module Ruflet
           warn "Set app.backend_url or backend_url in ruflet.yaml"
           return 1
         end
-        if experimental
-          build_args += ["--dart-define", "RUFLET_EXPERIMENTAL_NATIVE_RENDERER=true"]
-        end
         build_args << "-v" if verbose
         stage_ios_simulator_ruby_runtime(client_dir, build_args, verbose: !!verbose) if self_contained
 
@@ -326,10 +292,6 @@ module Ruflet
 
       private
 
-      def experimental_native_renderer?
-        @ruflet_experimental_native_renderer == true
-      end
-
       def extract_option_value!(args, *flags)
         flags.each do |flag|
           index = args.index(flag)
@@ -586,15 +548,10 @@ module Ruflet
         refreshed = refresh_managed_client_template_files(
           client_dir, platform: platform, verbose: verbose)
         return false if refreshed == false
-        unless configure_apple_renderer_integration(
-          client_dir, platform: platform, enabled: experimental_native_renderer?,
-          verbose: verbose)
+        unless remove_native_apple_renderer_integration(
+          client_dir, platform: platform, verbose: verbose)
           return false
         end
-        if experimental_native_renderer?
-          sync_application_apple_extensions(
-            client_dir, platform: platform, verbose: verbose)
-        end
         metadata = sync_client_metadata(client_dir, config, verbose: verbose)
         return false unless validate_mobile_app_identity(metadata, platform: platform)
 
@@ -605,7 +562,7 @@ module Ruflet
         return false if configured == false
         configure_native_apple_runtime(
           client_dir, platform: platform, self_contained: self_contained,
-          config: config, experimental: experimental_native_renderer?, verbose: verbose)
+          config: config, verbose: verbose)
         configure_android_runtime(
           client_dir, platform: platform, self_contained: self_contained,
           verbose: verbose)
@@ -614,11 +571,6 @@ module Ruflet
         if @ruflet_extension_selection_applied && !validate_flutter_extension_selection(client_dir)
           return false
         end
-        if experimental_native_renderer?
-          apply_native_apple_extension_config(
-            client_dir, platform: platform, extension_keys: extension_keys,
-            verbose: verbose)
-        end
         asset_flags = apply_build_config(client_dir, config)
         if asset_flags[:error]
           warn asset_flags[:error]
@@ -1731,15 +1683,12 @@ module Ruflet
 
       def apply_service_extension_config(client_dir, config = {}, self_contained: @ruflet_self_contained_build)
         extension_keys = configured_extension_keys(config)
-        # The experimental Apple host renders these extensions in Swift. Keep
-        # the resolved keys for native registration, but do not also ship the
-        # equivalent Dart plugins and their native Flutter frameworks.
-        flutter_extension_keys = experimental_native_renderer? ? [] : extension_keys
+        flutter_extension_keys = extension_keys
         extension_packages = flutter_extension_keys.filter_map { |key| CLIENT_EXTENSION_MAP[key]&.fetch(:package) }.uniq
         extension_aliases = flutter_extension_keys.filter_map { |key| CLIENT_EXTENSION_MAP[key]&.fetch(:alias) }.uniq
 
         configured_external = external_extension_entries(config)
-        external = experimental_native_renderer? ? [] : configured_external
+        external = configured_external
         previous_external_names = managed_external_extension_names(client_dir)
         discovered_external_names = discover_registered_external_extension_names(client_dir)
         removable_external_names = (
@@ -1773,9 +1722,6 @@ module Ruflet
         @ruflet_selected_external_extension_packages = external.map { |entry| entry[:name] }
         @ruflet_managed_external_extension_packages = removable_external_names
         @ruflet_extension_selection_applied = true
-        if experimental_native_renderer? && (!extension_keys.empty? || !configured_external.empty?)
-          build_note("Native Apple extensions selected; excluded equivalent Flutter plugins from the app bundle")
-        end
         extension_keys
       end
 
@@ -2249,7 +2195,10 @@ module Ruflet
       # A self-contained build needs the embedded VM. Prefer a local checkout so
       # the runtime under development is the one packaged, and otherwise resolve
       # the published package.
-      PUBLISHED_RUBY_RUNTIME_CONSTRAINT = "^0.0.9"
+      # 0.0.13 is the first release where the platform layer starts the VM and
+      # exposes serverUrl(); the client entrypoint calls it, so an older runtime
+      # would not build.
+      PUBLISHED_RUBY_RUNTIME_CONSTRAINT = "^0.0.14"
 
       def ruby_runtime_dependency(current_dependency = nil)
         if embedded_runtime_profile == :full && @ruflet_full_runtime_path
@@ -2341,16 +2290,10 @@ module Ruflet
         return false unless validate_template_ruflet_source_integrity(
           template_root, verbose: verbose)
 
-        if experimental_native_renderer? && %w[ios ipa macos].include?(platform.to_s)
-          return false unless validate_native_apple_renderer_distribution(
-            template_root, verbose: verbose)
-        end
-
         managed_files = [
           "lib/main.dart",
           "lib/main.self.dart",
           "lib/main.server.dart",
-          "lib/native_renderer.dart",
           "lib/connection_probe.dart",
           "lib/connection_probe_io.dart",
           "lib/connection_probe_stub.dart",
@@ -2371,7 +2314,6 @@ module Ruflet
           managed_files.concat(
             [
               "ios/Runner/AppDelegate.swift",
-              "ios/Runner/RufletEngineChoice.swift",
               "ios/Runner.xcodeproj/project.pbxproj"
             ]
           )
@@ -2379,7 +2321,6 @@ module Ruflet
           managed_files.concat(
             [
               "macos/Runner/MainFlutterWindow.swift",
-              "macos/Runner/RufletEngineChoice.swift",
               "macos/Runner.xcodeproj/project.pbxproj"
             ]
           )
@@ -2395,11 +2336,6 @@ module Ruflet
           build_log(verbose, "refreshed template file #{relative_path}")
         end
 
-        if experimental_native_renderer? && %w[ios ipa macos].include?(platform.to_s)
-          sync_managed_template_tree(
-            template_root, client_dir, "apple_packages/ruflet_apple", verbose: verbose)
-        end
-
         # Older managed clients carried a macOS-only FilePicker override. Ruflet's
         # core service owns FilePicker now, so this duplicate must not survive a
         # template refresh.
@@ -2475,44 +2411,17 @@ module Ruflet
         false
       end
 
-      # The standalone client template owns the editable Apple renderer. Build
-      # clients receive an exact managed copy from that package; there is no
-      # second renderer in this repository and no fallback implementation.
-      def validate_native_apple_renderer_distribution(template_root, verbose: false)
-        package_root = File.join(template_root, "apple_packages", "ruflet_apple")
-        required = [
-          "Package.swift",
-          "Sources/RufletEngine/RufletApp.swift",
-          "Sources/RufletEngine/RufletAppView.swift"
-        ]
-        missing = required.reject { |relative| File.file?(File.join(package_root, relative)) }
-        return true if missing.empty?
-
-        warn "build config error: the authoritative Apple renderer is incomplete"
-        missing.each { |relative| warn "  missing: apple_packages/ruflet_apple/#{relative}" }
-        false
-      end
-
-      def configure_apple_renderer_integration(client_dir, platform:, enabled:, verbose: false)
+      # Ruflet had a second, Swift-rendered Apple host. It is gone: every
+      # platform renders through the Ruflet Flutter engine. A client generated
+      # while it existed still carries the Swift package, the engine-choice
+      # shim and the Xcode references, so a rebuild strips them.
+      def remove_native_apple_renderer_integration(client_dir, platform:, verbose: false)
         apple_platform = case platform.to_s
         when "ios", "ipa" then "ios"
         when "macos" then "macos"
         end
         return true unless apple_platform
 
-        if enabled
-          package = File.join(client_dir, "apple_packages", "ruflet_apple", "Package.swift")
-          choice = File.join(client_dir, apple_platform, "Runner", "RufletEngineChoice.swift")
-          unless File.file?(package) && File.file?(choice)
-            warn "build config error: the Ruflet client template does not contain the native Apple renderer"
-            warn "Refresh the Ruflet template, then run the build again."
-            return false
-          end
-          configure_ios_scene_delegate(client_dir, native: true) if apple_platform == "ios"
-          build_log(verbose, "enabled experimental native Apple renderer")
-          return true
-        end
-
         unless restore_flutter_apple_host(client_dir, apple_platform, verbose: verbose)
           return false
         end
@@ -2520,12 +2429,12 @@ module Ruflet
         FileUtils.rm_f(File.join(client_dir, apple_platform, "Runner", "RufletEngineChoice.swift"))
         FileUtils.rm_rf(File.join(client_dir, "apple_packages"))
         FileUtils.rm_rf(File.join(client_dir, "apple_extensions"))
-        configure_ios_scene_delegate(client_dir, native: false) if apple_platform == "ios"
+        configure_ios_scene_delegate(client_dir) if apple_platform == "ios"
         apple_info_plist_paths(client_dir).each do |path|
           remove_plist_value(path, "RufletExperimentalNativeRenderer")
           remove_plist_value(path, "GADApplicationIdentifier")
         end
-        build_log(verbose, "using Flutter renderer; removed native Apple package integration")
+        build_log(verbose, "removed native Apple renderer integration")
         true
       end
 
@@ -2564,15 +2473,19 @@ module Ruflet
         write_text_file(path, content)
       end
 
-      def configure_ios_scene_delegate(client_dir, native:)
+      # Only the Flutter host remains, so the scene delegate is Flutter's own.
+      # A client built against the Swift renderer names RufletSceneDelegate,
+      # which lived in the deleted package -- launching it would trap on a
+      # missing class. FlutterSceneDelegate comes from the Flutter framework,
+      # so it carries no $(PRODUCT_MODULE_NAME) prefix.
+      def configure_ios_scene_delegate(client_dir)
         path = File.join(client_dir, "ios", "Runner", "Info.plist")
         return unless File.file?(path)
 
         content = read_text_file(path)
-        delegate = native ? "RufletSceneDelegate" : "SceneDelegate"
         content.gsub!(
-          %r{(<key>UISceneDelegateClassName</key>\s*<string>)\$\(PRODUCT_MODULE_NAME\)\.(?:RufletSceneDelegate|FlutterSceneDelegate|SceneDelegate)(</string>)}m,
-          "\\1$(PRODUCT_MODULE_NAME).#{delegate}\\2"
+          %r{(<key>UISceneDelegateClassName</key>\s*<string>)(?:\$\(PRODUCT_MODULE_NAME\)\.)?(?:RufletSceneDelegate|FlutterSceneDelegate|SceneDelegate)(</string>)}m,
+          "\\1FlutterSceneDelegate\\2"
         )
         write_text_file(path, content)
       end
@@ -2637,136 +2550,8 @@ module Ruflet
         write_text_file(path, content)
       end
 
-      def apply_native_apple_extension_config(
-        client_dir, platform:, extension_keys:, verbose: false
-      )
-        apple_platform = %w[ios ipa].include?(platform.to_s) ? "ios" : platform.to_s
-        return unless %w[ios macos].include?(apple_platform)
-
-        selected = Array(extension_keys).filter_map do |key|
-          spec = NATIVE_APPLE_EXTENSION_MAP[key]
-          [key, spec] if spec
-        end
-        selected_modules = selected.map { |_key, spec| spec.fetch(:module) }
-        unselected_modules = NATIVE_APPLE_EXTENSION_MAP.values
-          .map { |spec| spec.fetch(:module) }
-          .uniq - selected_modules
-
-        choice_path = File.join(client_dir, apple_platform, "Runner", "RufletEngineChoice.swift")
-        if File.file?(choice_path)
-          imports = selected_modules.map { |name| "import #{name}" }.join("\n")
-          registrations = selected.map do |_key, spec|
-            "    result.append(#{spec.fetch(:initializer)})"
-          end.join("\n")
-          source = <<~SWIFT
-            import Foundation
-            import RufletApple
-            import RufletAppExtensions
-            #{imports}
-
-            /// Generated by `ruflet build --experimental` from the same
-            /// services/extensions configuration used by the Flutter client.
-            enum RufletEngineChoice {
-              static var usesNativeRenderer: Bool {
-                let value = Bundle.main.object(
-                  forInfoDictionaryKey: "RufletExperimentalNativeRenderer")
-                if let flag = value as? Bool { return flag }
-                if let flag = value as? NSNumber { return flag.boolValue }
-                return false
-              }
-
-              static func pageURL(from raw: String) -> URL? {
-                RufletPageAddress.parse(raw)
-              }
-
-              @MainActor static var extensions: [any RufletExtension] {
-                var result = RufletAppExtensionRegistry.extensions
-            #{registrations}
-                return result
-              }
-            }
-          SWIFT
-          write_text_file(choice_path, source)
-        end
-
-        pbxproj = File.join(client_dir, apple_platform, "Runner.xcodeproj", "project.pbxproj")
-        if File.file?(pbxproj)
-          content = read_text_file(pbxproj)
-          content = content.lines.reject do |line|
-            unselected_modules.any? do |name|
-              line.match?(/\/\* #{Regexp.escape(name)}(?: in Frameworks)? \*\//)
-            end
-          end.join
-          write_text_file(pbxproj, content)
-        end
-
-        unless selected_modules.include?("RufletAds")
-          remove_plist_value(
-            File.join(client_dir, "ios", "Runner", "Info.plist"),
-            "GADApplicationIdentifier") if apple_platform == "ios"
-        end
-        build_log(
-          verbose,
-          "native Apple extensions=#{selected.empty? ? 'core only' : selected.map(&:first).join(',')}"
-        )
-      end
-
-      def sync_managed_template_tree(template_root, client_dir, relative_path, verbose: false)
-        source = File.join(template_root, relative_path)
-        return unless Dir.exist?(source)
-
-        destination = File.join(client_dir, relative_path)
-        sync_apple_source_tree(source, destination)
-        build_log(verbose, "refreshed template tree #{relative_path}")
-      end
-
-      # Application-defined RufletExtension implementations live outside the
-      # generated Flutter client. New projects own <project>/apple_extensions;
-      # existing projects receive the empty template registry until they opt
-      # in. Both server-driven and self-contained builds use the same package.
-      def sync_application_apple_extensions(client_dir, platform:, verbose: false)
-        return unless %w[ios ipa macos].include?(platform.to_s)
-
-        template_root = if Ruflet::CLI.respond_to?(:resolve_ruflet_client_template_root, true)
-          Ruflet::CLI.send(:resolve_ruflet_client_template_root)
-        end
-        project_source = File.join(Dir.pwd, "apple_extensions")
-        template_source = template_root && File.join(template_root, "apple_extensions")
-        source = if File.file?(File.join(project_source, "Package.swift"))
-          project_source
-        elsif template_source && File.file?(File.join(template_source, "Package.swift"))
-          template_source
-        end
-        return unless source
-
-        destination = File.join(client_dir, "apple_extensions")
-        sync_apple_source_tree(source, destination)
-        owner = source == project_source ? "project" : "template default"
-        build_log(verbose, "refreshed #{owner} Apple extensions")
-      end
-
-      def sync_apple_source_tree(source, destination)
-        FileUtils.rm_rf(destination)
-        FileUtils.mkdir_p(destination)
-        # SwiftPM and Dart create mutable caches directly inside the package.
-        # Copying the whole directory and deleting those caches afterwards is
-        # too late: framework resource symlinks inside `.build` can collide or
-        # escape while FileUtils is still traversing them. Treat only the
-        # package's source tree as managed template input from the outset.
-        generated_entries = %w[
-          .swiftpm .dart_tool .claude DerivedData xcuserdata
-        ]
-        Dir.children(source).each do |entry|
-          next if generated_entries.include?(entry) || entry == ".build" || entry.start_with?(".build-")
-
-          FileUtils.cp_r(
-            File.join(source, entry), File.join(destination, entry),
-            preserve: true)
-        end
-      end
-
       def configure_native_apple_runtime(
-        client_dir, platform:, self_contained:, config: {}, experimental: true, verbose: false
+        client_dir, platform:, self_contained:, config: {}, verbose: false
       )
         plist_paths = case platform.to_s
         when "ios", "ipa"
@@ -2787,9 +2572,7 @@ module Ruflet
           upsert_plist_string(
             path, "RufletRuntimeProfile",
             self_contained ? embedded_runtime_profile.to_s : "")
-          upsert_plist_boolean(
-            path, "RufletExperimentalNativeRenderer",
-            experimental)
+          remove_plist_value(path, "RufletExperimentalNativeRenderer")
           apple_platform = platform.to_s == "ipa" ? "ios" : platform.to_s
           platform_config = platform_build_config(config, apple_platform)
           if platform_config["local_network"] == true
@@ -3317,6 +3100,62 @@ module Ruflet
         name
       end
 
+      # Tells the platform layer to start the embedded runtime, and which
+      # packaged project to run.
+      #
+      # This is platform configuration rather than a dart-define because the VM
+      # starts before Dart does: on Apple platforms from the plugin's +load, on
+      # Android from an androidx.startup provider. Neither can read a value that
+      # only exists inside the Dart isolate.
+      #
+      # Desktop needs nothing here -- it has no manifest to carry a flag, and
+      # treats the presence of a packaged project as the opt-in, which is the
+      # same distinction this flag draws on the other platforms.
+      def configure_platform_autostart(client_dir, platform, verbose: false)
+        project = self_contained_project_name
+        case platform
+        when "ios", "macos"
+          plist = File.join(client_dir, platform, "Runner", "Info.plist")
+          return unless File.file?(plist)
+
+          set_plist_value(plist, "RufletRuntimeAutostart", "bool", "true")
+          set_plist_value(plist, "RufletEmbeddedProject", "string", project)
+          build_log(verbose, "enabled runtime autostart in #{platform}/Runner/Info.plist")
+        when "apk", "appbundle", "android"
+          manifest = File.join(
+            client_dir, "android", "app", "src", "main", "AndroidManifest.xml"
+          )
+          return unless File.file?(manifest)
+
+          set_android_meta_data(manifest, "ruflet.runtime.autostart", "true")
+          set_android_meta_data(manifest, "ruflet.runtime.project", project)
+          build_log(verbose, "enabled runtime autostart in AndroidManifest.xml")
+        end
+      end
+
+      def set_plist_value(plist, key, type, value)
+        # Delete first: PlistBuddy's Add fails on an existing key, and a rebuild
+        # after renaming the project would otherwise keep the stale name.
+        system("/usr/libexec/PlistBuddy", "-c", "Delete :#{key}", plist,
+               out: File::NULL, err: File::NULL)
+        system("/usr/libexec/PlistBuddy", "-c", "Add :#{key} #{type} #{value}",
+               plist, out: File::NULL, err: File::NULL)
+      end
+
+      def set_android_meta_data(manifest, name, value)
+        contents = File.read(manifest)
+        entry = %(<meta-data android:name="#{name}" android:value="#{value}" />)
+        existing = /<meta-data\s+android:name="#{Regexp.escape(name)}"[^>]*\/>/
+
+        contents =
+          if contents.match?(existing)
+            contents.sub(existing, entry)
+          else
+            contents.sub(%r{(\n(\s*)</application>)}) { "\n#{$2}    #{entry}#{$1}" }
+          end
+        File.write(manifest, contents)
+      end
+
       def skip_project_asset_directory?(relative)
         excluded_directories = %w[
           .git
@@ -3518,13 +3357,13 @@ module Ruflet
             queue << local
           end
         end
-        base = "file://#{URI::DEFAULT_PARSER.escape(File.expand_path(config_path))}"
+        base = file_uri_for(File.expand_path(config_path))
         expected.each do |name, root|
           entry = resolved.find { |package| package["name"] == name }
           raise "missing local package #{name}" unless entry
 
           uri = URI.join(base, entry.fetch("rootUri"))
-          actual = URI::DEFAULT_PARSER.unescape(uri.path)
+          actual = path_from_file_uri(uri)
           unless uri.scheme == "file" && File.realpath(actual) == File.realpath(root)
             raise "#{name} must resolve to the bundled Ruflet source at #{root}, got #{uri}"
           end
@@ -3536,6 +3375,21 @@ module Ruflet
         false
       end
 
+      # A POSIX path already starts with "/", so "file://" + path gives the
+      # three slashes a file URI needs. A Windows path starts with the drive
+      # ("D:/..."), and without the extra slash "D:" is parsed as the URI's
+      # host -- which is why this read every bundled package as missing there.
+      def file_uri_for(path)
+        escaped = URI::DEFAULT_PARSER.escape(path.tr("\\", "/"))
+        escaped.start_with?("/") ? "file://#{escaped}" : "file:///#{escaped}"
+      end
+
+      # And back: URI#path keeps that leading slash, so a Windows path returns
+      # as "/D:/..." which no file API accepts.
+      def path_from_file_uri(uri)
+        URI::DEFAULT_PARSER.unescape(uri.path).sub(%r{\A/(?=[A-Za-z]:)}, "")
+      end
+
       def template_client_pubspec_dependencies
         template_root =
           if Ruflet::CLI.respond_to?(:resolve_ruflet_client_template_root, true)

data/lib/ruflet/cli/new_command.rb

@@ -53,7 +53,6 @@ module Ruflet
         File.write(File.join(root, "README.md"), format(Ruflet::CLI::README_TEMPLATE, app_name: File.basename(root)))
         write_default_ruflet_config(root, File.basename(root))
         copy_default_project_assets(root)
-        copy_default_apple_extensions(root)
         project_name = File.basename(root)
         puts "Run:"
         puts "  cd #{project_name}"
@@ -368,21 +367,6 @@ module Ruflet
         end
       end
 
-      def copy_default_apple_extensions(root)
-        template_root = resolve_ruflet_client_template_root || ensure_cached_ruflet_client_template!
-        source = template_root && File.join(template_root, "apple_extensions")
-        return unless source && File.file?(File.join(source, "Package.swift"))
-
-        destination = File.join(root, "apple_extensions")
-        FileUtils.mkdir_p(destination)
-        generated_entries = %w[.build .swiftpm .dart_tool .claude]
-        Dir.children(source).each do |entry|
-          next if generated_entries.include?(entry)
-
-          FileUtils.cp_r(File.join(source, entry), File.join(destination, entry), preserve: true)
-        end
-      end
-
       def default_project_assets_root
         [
           File.expand_path("../../../assets", __dir__),

data/lib/ruflet/cli/run_command.rb

@@ -24,8 +24,6 @@ module Ruflet
       LEGACY_ASSET_PREFIX = "ruflet_client"
       CLIENT_CHANNEL_MANIFEST = "#{ASSET_PREFIX}-manifest.json"
       LEGACY_CLIENT_CHANNEL_MANIFEST = "#{LEGACY_ASSET_PREFIX}-manifest.json"
-      EXPERIMENTAL_IOS_SIMULATOR_ASSET = "#{ASSET_PREFIX}-ios-experimental-simulator.zip"
-      EXPERIMENTAL_MACOS_ASSET = "#{ASSET_PREFIX}-macos-experimental-universal.zip"
       DEFAULT_CLIENT_UPDATE_INTERVAL = 6 * 60 * 60
 
       def command_run(args)
@@ -39,9 +37,6 @@ module Ruflet
           return 1
         end
 
-        experimental_client = prepare_experimental_run_client(options)
-        return 1 if options[:experimental] && !experimental_client
-
         selected_port = resolve_backend_port(options[:target], requested_port: options[:requested_port])
         return 1 unless selected_port
         env = {
@@ -75,10 +70,7 @@ module Ruflet
 
         run_state = { child_pid: Process.spawn(env, *cmd, pgroup: true), restart: false }
         reload_input_thread = options[:reload] ? start_reload_input_thread(run_state) : nil
-        launched_client_pids = launch_target_client(
-          options[:target], selected_port,
-          experimental_client: experimental_client
-        )
+        launched_client_pids = launch_target_client(options[:target], selected_port)
         forward_signal = lambda do |signal|
           begin
             Process.kill(signal, -run_state[:child_pid])
@@ -134,71 +126,17 @@ module Ruflet
       private
 
       def parse_run_options(args)
-        options = { target: "mobile", requested_port: 8550, reload: true, experimental: false }
+        options = { target: "mobile", requested_port: 8550, reload: true }
         parser = OptionParser.new do |o|
           o.on("--web") { options[:target] = "web" }
           o.on("--desktop") { options[:target] = "desktop" }
           o.on("--port PORT", Integer) { |v| options[:requested_port] = v }
           o.on("--no-reload") { options[:reload] = false }
-          o.on("--experimental", "--exp") { options[:experimental] = true }
         end
         parser.parse!(args)
         options
       end
 
-      def prepare_experimental_run_client(options)
-        return nil unless options[:experimental]
-
-        if options[:target] == "web"
-          warn "run config error: --experimental/--exp is supported only for iOS and macOS"
-          return nil
-        end
-        unless host_platform_name == "macos"
-          warn "run config error: the experimental Apple client requires macOS"
-          return nil
-        end
-
-        if options[:target] == "desktop"
-          root = ensure_prebuilt_client(desktop_experimental: true, platform: "macos")
-          unless root
-            warn "Experimental macOS client is unavailable."
-            warn "The release must contain #{EXPERIMENTAL_MACOS_ASSET}."
-            return nil
-          end
-
-          return { kind: :desktop, root: root }
-        end
-
-        root = ensure_prebuilt_client(ios_experimental: true, platform: "macos")
-        unless root
-          warn "Experimental iOS Simulator client is unavailable."
-          warn "The release must contain #{EXPERIMENTAL_IOS_SIMULATOR_ASSET}."
-          return nil
-        end
-
-        app_bundle = experimental_ios_app_bundle(root)
-        simulator = booted_ios_simulator
-        unless simulator
-          warn "No booted iOS Simulator was found."
-          warn "Start the simulator you want to use, then run the command again."
-          return nil
-        end
-
-        bundle_identifier = ios_bundle_identifier(app_bundle)
-        if bundle_identifier.to_s.empty?
-          warn "Experimental client has no CFBundleIdentifier: #{app_bundle}"
-          return nil
-        end
-
-        {
-          kind: :ios_simulator,
-          app_bundle: app_bundle,
-          bundle_identifier: bundle_identifier,
-          simulator_udid: simulator.fetch("udid"),
-          simulator_name: simulator.fetch("name", simulator.fetch("udid"))
-        }
-      end
-
       def build_runtime_command(script_path, gemfile_path:, env:, reload: false)
         entry_script = script_path
         if reload
@@ -361,20 +299,9 @@ module Ruflet
         end
       end
 
-      def launch_target_client(target, port, experimental_client: nil)
+      def launch_target_client(target, port)
         wait_for_server_boot(port)
 
-        if experimental_client
-          if experimental_client[:kind] == :desktop
-            return launch_desktop_client(
-              "http://localhost:#{port}",
-              root: experimental_client.fetch(:root), experimental: true)
-          end
-
-          return launch_experimental_mobile_client(
-            "http://#{best_lan_host}:#{port}", client: experimental_client)
-        end
-
         case target
         when "web"
           launch_web_client(port)
@@ -385,33 +312,6 @@ module Ruflet
         end
       end
 
-      def launch_experimental_mobile_client(url, client:)
-        udid = client.fetch(:simulator_udid)
-        app_bundle = client.fetch(:app_bundle)
-        bundle_identifier = client.fetch(:bundle_identifier)
-
-        unless system("xcrun", "simctl", "install", udid, app_bundle)
-          warn "Failed to install the experimental client on #{client[:simulator_name] || udid}."
-          return []
-        end
-
-        launched = system(
-          { "SIMCTL_CHILD_RUFLET_URL" => url },
-          "xcrun", "simctl", "launch", "--terminate-running-process", udid, bundle_identifier
-        )
-        unless launched
-          warn "Failed to launch the experimental client on #{client[:simulator_name] || udid}."
-          return []
-        end
-
-        puts "Ruflet experimental client: #{client[:simulator_name] || udid}"
-        puts "Ruflet experimental backend: #{url}"
-        []
-      rescue StandardError => e
-        warn "Failed to launch experimental client: #{e.class}: #{e.message}"
-        []
-      end
-
       # The backend serves the web client on its own port, so the client reads
       # the origin it was loaded from and opens its websocket there. No URL is
       # passed in the query string: nothing in the client parses one.
@@ -511,8 +411,8 @@ module Ruflet
         nil
       end
 
-      def launch_desktop_client(url, root: nil, experimental: false)
-        cmd = detect_desktop_client_command(url, root: root, experimental: experimental)
+      def launch_desktop_client(url, root: nil)
+        cmd = detect_desktop_client_command(url, root: root)
         unless cmd
           warn "Desktop client executable not found."
           warn "Set RUFLET_CLIENT_DIR to your client path."
@@ -568,7 +468,7 @@ module Ruflet
           .find { |path| executable_file?(path) }
       end
 
-      def detect_desktop_client_command(url, root: nil, experimental: false)
+      def detect_desktop_client_command(url, root: nil)
         unless root
           root = ENV["RUFLET_CLIENT_DIR"]
           root = File.expand_path("ruflet_client", Dir.pwd) if root.to_s.strip.empty?
@@ -581,7 +481,7 @@ module Ruflet
         client_build_roots(root).each do |base|
           if host_os.match?(/darwin/i)
             search = %w[Release Debug].map { |config| File.join(base, "build", "macos", "Build", "Products", config) }
-            search << File.join(base, experimental ? "desktop-experimental" : "desktop")
+            search << File.join(base, "desktop")
             search.each do |dir|
               next unless Dir.exist?(dir)
 
@@ -636,10 +536,7 @@ module Ruflet
         nil
       end
 
-      def ensure_prebuilt_client(
-        web: false, desktop: false, desktop_experimental: false,
-        ios_experimental: false, platform: nil, force: false
-      )
+      def ensure_prebuilt_client(web: false, desktop: false, platform: nil, force: false)
         platform ||= host_platform_name
         return nil if platform.nil?
 
@@ -653,31 +550,8 @@ module Ruflet
           return nil if desktop_asset.nil?
           wanted_assets << { kind: :desktop, name: desktop_asset, platform: platform }
         end
-        if desktop_experimental
-          return nil unless platform == "macos"
-
-          wanted_assets << {
-            kind: :desktop_experimental,
-            name: EXPERIMENTAL_MACOS_ASSET,
-            platform: platform
-          }
-        end
-        if ios_experimental
-          return nil unless platform == "macos"
-
-          wanted_assets << {
-            kind: :ios_experimental,
-            name: EXPERIMENTAL_IOS_SIMULATOR_ASSET,
-            platform: platform
-          }
-        end
         cache_ready = wanted_assets.empty? || prebuilt_assets_present?(
-          cache_root,
-          web: web,
-          desktop: desktop,
-          desktop_experimental: desktop_experimental,
-          ios_experimental: ios_experimental,
-          platform: platform
+          cache_root, web: web, desktop: desktop, platform: platform
         )
         release = nil
         if !force && cache_ready
@@ -718,8 +592,6 @@ module Ruflet
             subdir = case wanted[:kind]
             when :web then "web"
             when :desktop then "desktop"
-            when :desktop_experimental then "desktop-experimental"
-            when :ios_experimental then "ios-experimental"
             end
             target = File.join(cache_root, subdir)
             FileUtils.rm_rf(target) if force && Dir.exist?(target)
@@ -739,12 +611,7 @@ module Ruflet
         end
 
         if prebuilt_assets_present?(
-          cache_root,
-          web: web,
-          desktop: desktop,
-          desktop_experimental: desktop_experimental,
-          ios_experimental: ios_experimental,
-          platform: platform
+          cache_root, web: web, desktop: desktop, platform: platform
         )
           write_client_manifest(cache_root, platform: platform, release: release, assets: installed_assets)
           return cache_root
@@ -761,61 +628,10 @@ module Ruflet
       # will actually accept later, or a half-extracted cache reports success
       # here and then fails to launch -- and, because a present cache short
       # circuits the download, never repairs itself without --force.
-      def prebuilt_assets_present?(
-        root, web:, desktop:, desktop_experimental: false,
-        ios_experimental: false, platform: nil
-      )
+      def prebuilt_assets_present?(root, web:, desktop:, platform: nil)
         ok_web = !web || built_web_client_dir?(File.join(root, "web"))
         ok_desktop = !desktop || prebuilt_desktop_present?(root, platform: platform)
-        ok_desktop_experimental = !desktop_experimental ||
-          prebuilt_experimental_desktop_present?(root, platform: platform)
-        ok_ios_experimental = !ios_experimental || !experimental_ios_app_bundle(root).nil?
-        ok_web && ok_desktop && ok_desktop_experimental && ok_ios_experimental
-      end
-
-      def experimental_ios_app_bundle(root)
-        ios_root = File.join(root, "ios-experimental")
-        return nil unless Dir.exist?(ios_root)
-
-        Dir.glob(File.join(ios_root, "*.app")).sort.find do |app_bundle|
-          File.file?(File.join(app_bundle, "Info.plist")) && ios_app_executable(app_bundle)
-        end
-      end
-
-      def ios_app_executable(app_bundle)
-        return nil unless Dir.exist?(app_bundle)
-
-        Dir.children(app_bundle)
-          .map { |entry| File.join(app_bundle, entry) }
-          .find { |path| executable_file?(path) }
-      end
-
-      def booted_ios_simulator
-        output, status = Open3.capture2e("xcrun", "simctl", "list", "devices", "booted", "--json")
-        return nil unless status.success?
-
-        devices = JSON.parse(output).fetch("devices", {})
-        devices.each do |runtime, candidates|
-          next unless runtime.to_s.include?("SimRuntime.iOS")
-
-          match = Array(candidates).find do |device|
-            device["state"] == "Booted" && device.fetch("isAvailable", true)
-          end
-          return match if match
-        end
-        nil
-      rescue StandardError
-        nil
-      end
-
-      def ios_bundle_identifier(app_bundle)
-        plist = File.join(app_bundle, "Info.plist")
-        output, status = Open3.capture2e(
-          "/usr/bin/plutil", "-extract", "CFBundleIdentifier", "raw", "-o", "-", plist
-        )
-        status.success? ? output.strip : nil
-      rescue StandardError
-        nil
+        ok_web && ok_desktop
       end
 
       # The prebuilt client is whatever `ruflet build` produced from Ruflet
@@ -841,17 +657,6 @@ module Ruflet
         end
       end
 
-      def prebuilt_experimental_desktop_present?(root, platform: nil)
-        return false unless (platform || host_platform_name) == "macos"
-
-        desktop = File.join(root, "desktop-experimental")
-        return false unless Dir.exist?(desktop)
-
-        Dir.glob(File.join(desktop, "*.app")).any? do |app_bundle|
-          macos_app_executable(app_bundle)
-        end
-      end
-
       def host_platform_name
         host_os = RbConfig::CONFIG["host_os"]
         return "macos" if host_os.match?(/darwin/i)
@@ -887,9 +692,7 @@ module Ruflet
       end
 
       def client_release_channel(wanted_assets: [])
-        default_channel = wanted_assets.any? do |wanted|
-          %i[desktop_experimental ios_experimental].include?(wanted[:kind])
-        end ? "prebuild-experimental" : "prebuild-main"
+        default_channel = "prebuild-main"
         value = ENV.fetch("RUFLET_CLIENT_CHANNEL", default_channel).to_s.strip
         value.empty? ? default_channel : value
       end
@@ -982,16 +785,11 @@ module Ruflet
           return n.include?("web") && (n.end_with?(".tar.gz") || n.end_with?(".zip"))
         end
 
-        if kind == :ios_experimental
-          return n.include?("ios") && n.include?("experimental") && n.include?("simulator") && n.end_with?(".zip")
-        end
-
-        if kind == :desktop_experimental
-          return n.include?("macos") && n.include?("experimental") && n.end_with?(".zip")
-        end
-
         case platform
         when "macos"
+          # Releases cut before the experimental channel was retired still carry
+          # ruflet_explorer-macos-experimental-universal.zip. Installing that as
+          # the desktop client would hand back the wrong app, so skip it.
           n.include?("macos") && !n.include?("experimental") && n.end_with?(".zip")
         when "linux"
           n.include?("linux") && (n.end_with?(".tar.gz") || n.end_with?(".tgz"))
@@ -1072,12 +870,6 @@ module Ruflet
         if prebuilt_desktop_present?(root, platform: platform)
           assets << { "kind" => "desktop", "platform" => platform, "asset_name" => nil }
         end
-        if prebuilt_experimental_desktop_present?(root, platform: platform)
-          assets << { "kind" => "desktop_experimental", "platform" => platform, "asset_name" => nil }
-        end
-        if experimental_ios_app_bundle(root)
-          assets << { "kind" => "ios_experimental", "platform" => platform, "asset_name" => nil }
-        end
         return if assets.empty?
 
         write_client_manifest(root, platform: platform, release: nil, assets: assets)

data/lib/ruflet/cli.rb

@@ -66,10 +66,10 @@ module Ruflet
           ruflet --version
           ruflet create <appname>
           ruflet new <appname>
-          ruflet run [scriptname|path] [--web|--desktop] [--experimental|--exp] [--port PORT] [--no-reload]
+          ruflet run [scriptname|path] [--web|--desktop] [--port PORT] [--no-reload]
           ruflet update [web|desktop|all] [--check] [--force] [--platform PLATFORM]
           ruflet debug [scriptname|path]
-          ruflet build <apk|android|ios|ipa|aab|web|macos|windows|linux> [--lite|--full|--self] [--experimental|--exp] [--verbose]
+          ruflet build <apk|android|ios|ipa|aab|web|macos|windows|linux> [--lite|--full|--self] [--verbose]
           ruflet install [--device DEVICE_ID] [--verbose]
           ruflet devices
           ruflet emulators

data/lib/ruflet/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ruflet
-  VERSION = "0.0.22" unless const_defined?(:VERSION)
+  VERSION = "0.0.23" unless const_defined?(:VERSION)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruflet
 version: !ruby/object:Gem::Version
-  version: 0.0.22
+  version: 0.0.23
 platform: ruby
 authors:
 - AdamMusa