Skip to content

Latest commit

 

History

History
19 lines (16 loc) · 1.82 KB

Impeller-Scene.md

File metadata and controls

19 lines (16 loc) · 1.82 KB

We are excited to have you tinker on the Impeller Scene Demo presented at Flutter Forward. While we spend time learning the use-cases and finalizing the API, the functionality for Impeller Scene is behind a compile-time flag. During this time, there are no guarantees around API stability.

Compiling the Engine

  • Configure your Mac host to compile the Flutter Engine by following the guidance in wiki.
  • Ensure that you are on the main branch of the Flutter Engine.
  • Ensure that you are on the main branch of the Flutter Framework.
  • Configure the host build: ./flutter/tools/gn --enable-impeller-3d --no-lto
  • Configure the iOS build: ./flutter/tools/gn --enable-impeller-3d --no-lto --ios
    • Add the --simulator --simulator-cpu=arm64 flag to the iOS build if you are going to test on the simulator.
  • Build host artifacts (this will take a while): ninja -C out/host_debug
  • Build iOS artifacts (this will take a while): ninja -C out/ios_debug
    • If targeting the simulator: ninja -C out/ios_debug_sim_arm64
  • Clone the demo repository: git clone https://github.com/bdero/flutter-scene-example.git and move into the directory.
  • Plug in your device or open Simulator.app, then run flutter devices to note the device identifier.
  • Run the demo application: flutter run -d [device_id] --local-engine ios_debug --local-engine-host host_debug (or ios_debug_sim_arm64 if you are running on the Simulator).
    • On Silicon Macs, prefer --local-engine-host host_debug_arm64 (adjusting your ninja command above accordingly)

We hope to continue evolving the API and have it available on the stable channel soon!