motion-cross-platform 1.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56c3e353042268f94150b0dd2f0852e576ab0c2944dc5336d55a6647aef9c907
-  data.tar.gz: 00bf2f4df6eeef0eb6ed01d926bc3ac807dc22b18af356b15edac1aa0334e027
+  metadata.gz: 45f72c8cec1453a4143c63f042a2162bb203e068a6d9a03f2ab81ad5db082e8b
+  data.tar.gz: 1adb7cee10c7562f6004cb3e504ad1b327f143af0dea3a24072a0efc975403ac
 SHA512:
-  metadata.gz: 7073a861a06f8723e971c747cf650cd867e2e363a2d6c25eb377476c440439e6661aed9146b0cfcb4b62d375454199131e765449523e64c9cc518e03997988c4
-  data.tar.gz: cd72e96c1a74b08bedb3b234037321ce1984644e941ec29125f1697ed443640413459f8f84f116a912681aee72b50f9ebacbb5a712f44f8e270c1675428839fd
+  metadata.gz: 82e70c5e6e82e7e254a5f5fcdcc1f7752a069c74eaf24d68787948260b3f9928b12257bf54675aef7e8ab5763cc917195a94b53a54012a1a72666da338a4bb49
+  data.tar.gz: bbcf518db5cfe438e2850045261fc5d2d5318fd3af5037cead6f3428da296687b112aaf3f3fd7d5f5cd62913b2e8bde677ebc3ad2913ff0ac014c8373abfa256

data/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [1.0.1] - 2026-08-03
+
+This release is a ground-up rewrite of the gem internals. The public interface — `require "motion-cross-platform"` in your Rakefile and the namespaced rake tasks — is unchanged.
+
+### Fixed
+
+- Platform source filtering was broken in 1.0: every platform setup referenced an undefined `path` variable, raising a `NameError` during builds.
+
+### Added
+
+- `app/cocoa/` directory convention for code shared between iOS and macOS (excluded from Android builds).
+- Per-platform spec directories: `spec/ios/`, `spec/android/`, and `spec/osx/` are filtered so each platform runs only its own specs, plus any shared specs at the `spec/` root.
+- Android: an emulator is booted automatically when one is needed and none is running (first available AVD, waits for boot to complete).
+- Android: builds output to `build/android` and use `resources/` as the assets directory.
+- A demo app (`demo_app/`) exercising all three platforms, used to develop and test the gem.
+
+### Changed
+
+- Internal restructure: code now lives in `lib/motion-cross-platform/` (previously `lib/motion/project/cross_platform/`).
+
+## [1.0] - 2024-03-05
+
+- Initial release: namespaced rake tasks (`rake ios`, `rake android`, `rake osx`) proxying RubyMotion's per-platform build templates, platform-specific source directories (`app/ios/`, `app/android/`, `app/osx/`), per-platform configuration in a single Rakefile via `app.platform`, and a combined iOS + Android "super REPL" (`rake mobile`).

data/README.md

@@ -1,6 +1,8 @@
 # motion-cross-platform
 
-Provides a common starting point for cross-platform RubyMotion gems and applications.
+Build iOS, Android, and macOS apps and gems from a single RubyMotion codebase.
+
+This gem provides a project structure allowing you to share code across iOS, Android, and macOS platforms while maintaining platform-specific customizations where needed.
 
 ## Installation
 
@@ -18,7 +20,74 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### Project Structure
+
+Organize your app code into platform-specific directories:
+
+```
+app/
+  app_delegate.rb      # Shared code (loaded by all platforms)
+  ios/                 # iOS-specific code
+  android/             # Android-specific code
+  osx/                 # macOS-specific code
+  cocoa/               # Shared iOS/macOS code (excluded from Android)
+```
+
+### Configuration
+
+In your `Rakefile`, use the `platform` helper to define platform-specific settings:
+
+```ruby
+Motion::Project::App.setup do |app|
+  app.name = 'MyApp'
+
+  app.platform :ios do
+    app.deployment_target = '12.0'
+  end
+
+  app.platform :android do
+    app.api_version = '29'
+  end
+
+  app.platform :osx do
+    app.deployment_target = '10.14'
+  end
+end
+```
+
+### Running Your App
+
+Build and run for each platform using the namespaced rake tasks:
+
+```bash
+# iOS
+rake ios              # Build and run in simulator
+rake ios:device       # Build and run on device
+rake ios:spec         # Run tests in simulator
+
+# Android
+rake android          # Build and run in emulator
+rake android:device   # Build and run on device
+rake android:spec     # Run tests in emulator
+
+# macOS
+rake osx              # Build and run
+rake osx:spec         # Run tests
+```
+
+### Super REPL
+
+Run iOS and Android simultaneously with a combined REPL:
+
+```bash
+rake mobile           # or: rake super_repl
+```
+
+This launches both simulators and lets you evaluate Ruby expressions on both platforms at once.
+
+### Available Tasks
+
+Run `rake -T` to see all available tasks, or `rake ios -T`, `rake android -T`, `rake osx -T` for platform-specific tasks.
 
 ## Contributing
 

data/lib/{motion/project/cross_platform → motion-cross-platform}/config.rb

@@ -6,8 +6,7 @@ module Motion
       # Allows us to define the config in one file but only
       # execute it when it matches the specified platform.
       def platform(platform_name)
-        return unless platform_name.to_sym == template
-        yield
+        yield if platform_name.to_sym == template
       end
     end
   end

data/lib/motion-cross-platform/rake_tasks.rb

@@ -0,0 +1,138 @@
+# encoding: utf-8
+
+if platform = ENV["platform"]
+  require_relative "config"
+  require_relative "setup_#{platform}"
+else
+  require_relative "helpers"
+
+  desc "Build the app, then run it in the emulator"
+  task :android => "android:emulator"
+
+  define_rake_tasks(
+    android: {
+      "build"              => "Create an application package file (.apk)",
+      "clean"              => "Clear local build objects",
+      "clean:all"          => "Clean all build objects",
+      "config"             => "Show project config",
+      "ctags"              => "Generate ctags",
+      "device"             => "Build the app then run it on the device",
+      "device:install"     => "Install the app on the device",
+      "device:start"       => "Start the app's main intent on the device",
+      "emulator"           => "Build the app then run it in the emulator",
+      "emulator:boot"      => "Boot an emulator if one is not already running",
+      "emulator:install"   => "Install the app in the emulator",
+      "emulator:start"     => "Start the app's main intent in the emulator",
+      "release"            => "Create an application package file (.apk) for release (Google Play)",
+      "spec"               => "Same as spec:emulator",
+      "spec:device"        => "Run the test/spec suite on the device",
+      "spec:emulator"      => "Run the test/spec suite in the emulator",
+      "gradle:install"     => "Download and build dependencies"
+    }
+  )
+
+  desc "Build the app, then run it in the simulator"
+  task :ios => "ios:simulator"
+
+  define_rake_tasks(
+    ios: {
+      "archive"                     => "Create an .ipa archive",
+      "archive:distribution"        => "Create an .ipa archive for distribution (AppStore)",
+      "build"                       => "Build everything",
+      "build:device"                => "Build the device version",
+      "build:simulator"             => "Build the simulator version",
+      "clean"                       => "Clear local build objects",
+      "clean:all"                   => "Clean all build objects",
+      "config"                      => "Show project config",
+      "crashlog"                    => "Same as crashlog:simulator",
+      "crashlog:device"             => "Retrieve and symbolicate crash logs generated by the app on the device, and open the latest generated one",
+      "crashlog:simulator"          => "Open the latest crash report generated by the app in the simulator",
+      "ctags"                       => "Generate ctags",
+      "device"                      => "Deploy on the device",
+      "profile"                     => "Same as profile:simulator",
+      "profile:device"              => "Run a build on the device through Instruments",
+      "profile:device:templates"    => "List all built-in device Instruments templates",
+      "profile:simulator"           => "Run a build on the simulator through Instruments",
+      "profile:simulator:templates" => "List all built-in Simulator Instruments templates",
+      "simulator"                   => "Run the simulator",
+      "spec"                        => "Same as spec:simulator",
+      "spec:device"                 => "Run the test/spec suite on the device",
+      "spec:simulator"              => "Run the test/spec suite in the simulator",
+      "static"                      => "Create a .a static library",
+      "watch"                       => "Same as watch:simulator",
+      "watch:simulator"             => "Run the Watch application on the simulator"
+    }
+  )
+
+  desc "Build the app, then run it"
+  task :osx => "osx:run"
+
+  define_rake_tasks(
+    osx: {
+      "archive"              => "Create a .pkg archive",
+      "archive:distribution" => "Create a .pkg archive for distribution (AppStore)",
+      "build"                => "Build the project for development",
+      "build:release"        => "Build the project for release",
+      "clean"                => "Clear local build objects",
+      "config"               => "Show project config",
+      "crashlog"             => "Open the latest crash report generated for the app",
+      "run"                  => "Run the project",
+      "spec"                 => "Run the test/spec suite",
+      "static"               => "Create a .a static library"
+    }
+  )
+
+  desc "Build and launch both iOS and Android in a combined REPL"
+  task mobile: :super_repl
+
+  desc "Start a combined iOS/Android REPL"
+  task "super_repl" do
+    require "readline"
+
+    cmd = %w{ rake }
+    ios_cmd = cmd + ["ios:simulator"]
+    android_cmd = cmd + ["android:emulator:start"]
+
+    if ENV.fetch("skip_build", nil)
+      ios_cmd << "skip_build=1"
+      android_cmd << "skip_build=1"
+    end
+
+    ios_io = nil
+    android_io = nil
+
+    begin
+      puts "Starting iOS simulator..."
+      ios_io = IO.popen(ios_cmd.join(" "), "w")
+
+      puts "Starting Android emulator..."
+      android_io = IO.popen(android_cmd.join(" "), "w")
+
+      puts "Super REPL ready. Type expressions to evaluate on both platforms."
+      puts "Press Ctrl-D or type 'exit' to quit.\n\n"
+
+      while expr = Readline.readline("> ", true)
+        break if expr.strip.downcase == "exit"
+
+        ios_io.puts expr unless ios_io.closed?
+        android_io.puts expr unless android_io.closed?
+        sleep 0.2
+      end
+    rescue Interrupt
+      puts "\nInterrupted."
+    rescue Errno::EPIPE => e
+      puts "\nError: Lost connection to a simulator process."
+      puts "One of the processes may have crashed: #{e.message}"
+    ensure
+      puts "\nShutting down..."
+      [ios_io, android_io].compact.each do |io|
+        begin
+          io.close unless io.closed?
+        rescue IOError
+          # Already closed, ignore
+        end
+      end
+      puts "Super REPL closed."
+    end
+  end
+end

data/lib/motion-cross-platform/setup_android.rb

@@ -0,0 +1,89 @@
+# encoding: utf-8
+
+require "motion/project/template/android"
+begin
+  require "motion-gradle"
+rescue LoadError
+end
+
+Motion::Project::App.setup do |app|
+  app.build_dir = "build/android"
+  app.assets_dirs << "resources"
+  app.resources_dirs = []
+
+  app.files.delete_if {|path| path.start_with?("./app/ios") }
+  app.files.delete_if {|path| path.start_with?("./app/osx") }
+  app.files.delete_if {|path| path.start_with?("./app/cocoa") }
+
+  app.spec_files.delete_if {|path| path.start_with?("./spec/ios") }
+  app.spec_files.delete_if {|path| path.start_with?("./spec/osx") }
+end
+
+# adb_path is provided by the android template.
+def emulator_path
+  "#{App.config.sdk_path}/emulator/emulator"
+end
+
+def available_avds
+  `"#{emulator_path}" -list-avds 2>/dev/null`.strip.split("\n").reject(&:empty?)
+end
+
+def running_emulator_id
+  output = `"#{adb_path}" -e devices 2>/dev/null`
+  # Parse output to find emulator device (e.g., "emulator-5554")
+  output.lines.drop(1).each do |line|
+    device = line.split.first
+    return device if device && device.start_with?("emulator-")
+  end
+  nil
+end
+
+def ensure_emulator_running
+  if running_emulator_id
+    App.info "Emulate", "Emulator is already running"
+    return
+  end
+
+  avds = available_avds
+  if avds.empty?
+    App.fail "No emulators found. Create one with Android Studio or `avdmanager`."
+  end
+
+  avd_name = avds.first
+  App.info "Emulate", "Starting emulator \"#{avd_name}\"..."
+
+  # Start emulator in background
+  Process.detach(spawn(emulator_path, "-avd", avd_name, [:out, :err] => "/dev/null"))
+
+  # Wait for emulator to be ready
+  App.info "Emulate", "Waiting for emulator to boot..."
+  timeout = 120 # seconds
+  start_time = Time.now
+
+  loop do
+    if Time.now - start_time > timeout
+      App.fail "Emulator failed to start within #{timeout} seconds"
+    end
+
+    if running_emulator_id
+      boot_completed = `"#{adb_path}" -e shell getprop sys.boot_completed 2>/dev/null`.strip
+      if boot_completed == "1"
+        break
+      end
+    end
+
+    sleep 2
+  end
+end
+
+namespace :emulator do
+  desc "Boot an emulator if one is not already running"
+  task :boot do
+    ensure_emulator_running
+  end
+end
+
+# adb-based emulator tasks fail unless an emulator is already running.
+%w[emulator:install emulator:start].each do |task_name|
+  Rake::Task[task_name].enhance(["emulator:boot"])
+end

data/lib/motion-cross-platform/setup_ios.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+require "motion/project/template/ios"
+begin
+  require "motion-cocoapods"
+rescue LoadError
+end
+
+Motion::Project::App.setup do |app|
+  app.files.delete_if {|path| path.start_with?("./app/android") }
+  app.files.delete_if {|path| path.start_with?("./app/osx") }
+
+  app.spec_files.delete_if {|path| path.start_with?("./spec/android") }
+  app.spec_files.delete_if {|path| path.start_with?("./spec/osx") }
+end

data/lib/motion-cross-platform/setup_osx.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+require "motion/project/template/osx"
+begin
+  require "motion-cocoapods"
+rescue LoadError
+end
+
+Motion::Project::App.setup do |app|
+  app.files.delete_if {|path| path.start_with?("./app/android") }
+  app.files.delete_if {|path| path.start_with?("./app/ios") }
+
+  app.spec_files.delete_if {|path| path.start_with?("./spec/android") }
+  app.spec_files.delete_if {|path| path.start_with?("./spec/ios") }
+end

data/lib/{motion/project/cross_platform → motion-cross-platform}/stubs.rb

@@ -2,13 +2,9 @@ module Motion
   module Project
     class Config
     end
-  end
-end
 
-module Motion
-  module Project
     class App
-      def template
+      def self.template
         :cross_platform
       end
 

data/lib/motion-cross-platform.rb

@@ -1,3 +1,4 @@
 # encoding: utf-8
 
-require_relative "motion/project/cross_platform/rake_tasks"
+require_relative "motion-cross-platform/stubs"
+require_relative "motion-cross-platform/rake_tasks"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: motion-cross-platform
 version: !ruby/object:Gem::Version
-  version: '1.0'
+  version: 1.0.1
 platform: ruby
 authors:
 - Andrew Havens
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -24,29 +23,30 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Provides a common starting point for cross-platform RubyMotion gems and
-  applications.
+description: Adds namespaced rake tasks (rake ios, rake android, rake osx) and source
+  directory conventions so one RubyMotion project can target iOS, Android, and macOS
+  — shared code lives in app/, platform-specific code in app/ios, app/android, and
+  app/osx, and per-platform configuration in a single Rakefile.
 email:
 - email@andrewhavens.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - README.md
 - lib/motion-cross-platform.rb
-- lib/motion/project/cross_platform.rb
-- lib/motion/project/cross_platform/android_setup.rb
-- lib/motion/project/cross_platform/config.rb
-- lib/motion/project/cross_platform/helpers.rb
-- lib/motion/project/cross_platform/ios_setup.rb
-- lib/motion/project/cross_platform/osx_setup.rb
-- lib/motion/project/cross_platform/rake_tasks.rb
-- lib/motion/project/cross_platform/stubs.rb
+- lib/motion-cross-platform/config.rb
+- lib/motion-cross-platform/helpers.rb
+- lib/motion-cross-platform/rake_tasks.rb
+- lib/motion-cross-platform/setup_android.rb
+- lib/motion-cross-platform/setup_ios.rb
+- lib/motion-cross-platform/setup_osx.rb
+- lib/motion-cross-platform/stubs.rb
 homepage: https://github.com/rubymotion-community/motion-cross-platform
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -61,8 +61,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
-summary: Provides a common starting point for cross-platform RubyMotion gems and applications.
+summary: Build iOS, Android, and macOS apps and gems from a single RubyMotion codebase.
 test_files: []

data/lib/motion/project/cross_platform/android_setup.rb

@@ -1,17 +0,0 @@
-# encoding: utf-8
-
-require "motion/project/template/android"
-begin
-  require "motion-gradle"
-rescue LoadError
-end
-
-Motion::Project::App.setup do |app|
-  app.build_dir = "build/android"
-  app.assets_dirs << "resources"
-  app.resources_dirs = []
-
-  app.files.delete_if { path.start_with?("./app/ios") }
-  app.files.delete_if { path.start_with?("./app/osx") }
-  app.files.delete_if { path.start_with?("./app/cocoa") }
-end

data/lib/motion/project/cross_platform/ios_setup.rb

@@ -1,12 +0,0 @@
-# encoding: utf-8
-
-require "motion/project/template/ios"
-begin
-  require "motion-cocoapods"
-rescue LoadError
-end
-
-Motion::Project::App.setup do |app|
-  app.files.delete_if { path.start_with?("./app/android") }
-  app.files.delete_if { path.start_with?("./app/osx") }
-end

data/lib/motion/project/cross_platform/osx_setup.rb

@@ -1,12 +0,0 @@
-# encoding: utf-8
-
-require "motion/project/template/osx"
-begin
-  require "motion-cocoapods"
-rescue LoadError
-end
-
-Motion::Project::App.setup do |app|
-  app.files.delete_if { path.start_with?("./app/android") }
-  app.files.delete_if { path.start_with?("./app/ios") }
-end

data/lib/motion/project/cross_platform/rake_tasks.rb

@@ -1,95 +0,0 @@
-# encoding: utf-8
-
-if platform = ENV["platform"]
-  require_relative "config"
-  require_relative "#{platform}_setup"
-else
-  require_relative "stubs"
-  require_relative "helpers"
-
-  define_rake_tasks(
-    android: {
-      "build"                => "Create an application package file (.apk)",
-      "clean"                => "Clear local build objects",
-      "clean:all"            => "Clean all build objects",
-      "config"               => "Show project config",
-      "ctags"                => "Generate ctags",
-      "default"              => "Same as emulator",
-      "device"               => "Build the app then run it on the device",
-      "device:install"       => "Install the app on the device",
-      "device:start"         => "Start the app's main intent on the device",
-      "emulator"             => "Build the app then run it in the emulator",
-      "emulator:install"     => "Install the app in the emulator",
-      "emulator:start"       => "Start the app's main intent in the emulator",
-      "release"              => "Create an application package file (.apk) for release (Google Play)",
-      "spec"                 => "Same as spec:emulator",
-      "spec:device"          => "Run the test/spec suite on the device",
-      "spec:emulator"        => "Run the test/spec suite in the emulator",
-      "gradle:install"       => "Download and build dependencies"
-    },
-    ios: {
-      "archive"              => "Create an .ipa archive",
-      "archive:distribution" => "Create an .ipa archive for distribution (AppStore)",
-      "build"                => "Build everything",
-      "build:device"         => "Build the device version",
-      "build:simulator"      => "Build the simulator version",
-      "clean"                => "Clear local build objects",
-      "clean:all"            => "Clean all build objects",
-      "config"               => "Show project config",
-      "crashlog"             => "Same as crashlog:simulator",
-      "crashlog:device"      => "Retrieve and symbolicate crash logs generated by the app on the device, and open the latest generated one",
-      "crashlog:simulator"   => "Open the latest crash report generated by the app in the simulator",
-      "ctags"                => "Generate ctags",
-      "default"              => "Build the project, then run the simulator",
-      "device"               => "Deploy on the device",
-      "profile"              => "Same as profile:simulator",
-      "profile:device"       => "Run a build on the device through Instruments",
-      "profile:device:templates" => "List all built-in device Instruments templates",
-      "profile:simulator"    => "Run a build on the simulator through Instruments",
-      "profile:simulator:templates" => "List all built-in Simulator Instruments templates",
-      "simulator"            => "Run the simulator",
-      "spec"                 => "Same as spec:simulator",
-      "spec:device"          => "Run the test/spec suite on the device",
-      "spec:simulator"       => "Run the test/spec suite in the simulator",
-      "static"               => "Create a .a static library",
-      "watch"                => "Same as watch:simulator",
-      "watch:simulator"      => "Run the Watch application on the simulator"
-    },
-    osx: {
-      "archive"              => "Create a .pkg archive",
-      "archive:distribution" => "Create a .pkg archive for distribution (AppStore)",
-      "build"                => "Build the project for development",
-      "build:release"        => "Build the project for release",
-      "clean"                => "Clear local build objects",
-      "config"               => "Show project config",
-      "crashlog"             => "Open the latest crash report generated for the app",
-      "default"              => "Build the project, then run the app",
-      "run"                  => "Run the project",
-      "spec"                 => "Run the test/spec suite",
-      "static"               => "Create a .a static library"
-    }
-  )
-
-  desc "Start a combined iOS/Android REPL"
-  task "super_repl" do
-    require "readline"
-
-    cmd = %w{ rake }
-    ios_cmd = cmd + ["ios:simulator"]
-    android_cmd = cmd + ["android:emulator:start"]
-
-    if ENV.fetch("skip_build", nil)
-      ios_cmd << "skip_build=1"
-      android_cmd << "skip_build=1"
-    end
-
-    ios_io = IO.popen(ios_cmd.join(" "), "w")
-    android_io = IO.popen(android_cmd.join(" "), "w")
-
-    while expr = Readline.readline("> ", true)
-      ios_io.puts expr
-      android_io.puts expr
-      sleep 0.2
-    end
-  end
-end

data/lib/motion/project/cross_platform.rb

@@ -1 +0,0 @@
-require_relative "cross_platform/rake_tasks"