Skip to content

iPad:首次运行演示、内置帮助页,以及可签名的 Xcode 工程 - #28

Closed
W-MS wants to merge 22 commits into
standalonefrom
ipados
Closed

W-MS wants to merge 22 commits into
standalonefrom
ipados

Conversation

@W-MS

@W-MS W-MS commented Oct 28, 2026

Copy link
Copy Markdown
Owner

概要

iPad 版补上首次运行的演示工程和引导,帮助里的网页改在应用内打开,并增加一个在 Mac 上生成可签名 Xcode 工程的脚本。现有的 ipados.yml 打包流程没有改。

演示工程

  • assets 里的 wav 打进应用包的 Demo/Demo.wav,不复制到用户目录。
  • 第一次引导结束(或用户退出引导)后,在 Documents/Projects/Demo.otproj 生成工程。工程里的 relativeMediaPath 写成从工程目录指向包内音频的相对路径。
  • 应用更新后包路径会变,每次启动只修复已经失效的引用。用户保存过、媒体已进 .Demo_Media 的工程不动。
  • 引导顺序:双击片段进入钢琴卷帘 → 渲染条旁说明(没有渲染任务时显示 0/0,点掉提示前不消失)→ 右侧工具长按可看用法 → 结束。
  • iPad 引导不再询问 OpenTune / OpenDyne,默认 OpenTune。渲染徽标加大,并注明播放时先听到原始音高。

帮助

  • 用户手册和「关于」里的 http(s) 链接在 iPad 上用右侧 WebView 抽屉打开,可随时关闭。桌面版仍走系统浏览器。

Xcode / App Store

  • 在 Mac 上运行 ./makeXcodeProject.sh。脚本下载依赖,并在 Build/ipados-xcode/(已 gitignore)生成工程。
  • 打开后选择开发团队即可运行;Product > Archive 后可提交 App Store。
  • 打包进包内的模型、演示音频和用户手册在 Archive 时仍会复制进去。Bundle ID 和构建号可用参数覆盖,默认构建号每次生成都会变。
Open in Web Open in Cursor 

YuFeng926 and others added 22 commits October 26, 2026 10:43
* feat(ipados): treat iOS keyboard modifiers like macOS (Cmd shortcuts, shift-wheel)


* feat(ipados): sandbox-aware import/export/save dialogs and fullscreen window


* build(ipados): iOS Standalone-only CMake target with static ONNX Runtime xcframework


* ci(ipados): add iPadOS compile workflow producing an unsigned IPA


* fix(ipados): avoid unreachable window-geometry code on iOS


* ci(ipados): build feature branches only through their pull request


* feat(ipados): default UI language follows device language on first launch


* feat(ipados): tell finger touches from pointer input and hide the mouse trail for fingers

JUCE reports every iOS event as a touch. Observe UITouch.type with a passive
per-window gesture recognizer (plus a hover recognizer) and opt in to
UIApplicationSupportsIndirectInputEvents so trackpad/mouse clicks arrive as
indirect pointer touches. The mouse trail is drawn only for pointer input.


* fix(ipados): present UIDocumentPickerViewController directly for imports

juce::FileChooser on iOS routes picks through NSFileCoordinator and silently
drops the callback on a coordination error, leaving import stuck on the
picker. Open audio as copies and move them into Documents/Imported; open
projects in place with security-scoped access.


* feat(ipados): finger gestures in the piano roll

Finger input only (mouse, trackpad and Pencil keep the desktop behaviour):
- drag on empty space pans the view in both axes
- double tap on empty space toggles play/pause
- two-finger pinch zooms the time axis, the pitch axis, or both,
  depending on the angle between the fingers; the midpoint pans
- dragging a note still corrects pitch; taps still move the playhead


* feat(ipados): long-press a track header to open the track menu

Touch long press (500 ms, cancelled by >10 px movement) opens the same menu
as right-click: add, duplicate, colour, delete. The menu is placed beside
the finger with taller items so lifting the finger cannot pick an item.


* fix(ipados): show the numeric keyboard when editing BPM

The BPM field is self-drawn and not a TextInputTarget, so iOS never raised
the soft keyboard. On iOS, tapping the value overlays a TextEditor with the
decimal keyboard; Return or tapping away commits, Escape cancels.


* feat(ipados): show a 2-second label when a top-bar button is touched

juce::TooltipWindow ignores touch input, so iPad users never saw what the
toolbar icons do. TopBarComponent now shows the touched control's tooltip
in a bubble below it for 2 s (longer while held), then fades it out. The
side-panel toggles and play/pause are excluded.


* ci(ipados): configurable runner defaulting to macos-15-intel; check indirect-input plist key


* fix(ipados): silence switch-enum and init-capture shadow warnings in the iOS code


* fix(ipados): keep the touch label beneath open popup menus

The label was a front-most child of the editor while menus are children of
the editor's content root, so it covered the File/Edit/View menus. Put it in
the same container and keep it behind any modal sibling.


* fix(ipados): rename picker init-capture to avoid shadow warning


---------
Finger input only: a tap on empty space still seeks and clears the
selection (now on release), a drag on empty space pans both axes, a double
tap toggles play/pause, and a two-finger pinch zooms the time axis and/or
the track height by finger angle. Clips, edges and the ruler keep their
existing touch behaviour.
On iOS, Open Project lists the .otproj files under the app's Documents
(newest first) instead of going straight to the system picker; Browse
Files... remains as a fallback. The project type is now declared in
Info.plist so the picker recognises .otproj, and project media folders are
dot-prefixed so the Files app hides them.
juce::PopupMenu opens a submenu only after the pointer rests on its item for
~100 ms, so a finger tap never opened it. On iOS a global touch listener
invokes the item's accessibility showMenu action when a submenu item is
tapped.
After naming the export, iOS asks whether to keep it in the OpenTune Exports
folder or choose a location in Files; the latter renders into Exports and then
moves the file with the system export picker (cancel keeps it in Exports).
Matches the track header's long-press menu; mouse/trackpad menus keep the
compact desktop height.
TouchTooltipPresenter gains a long-press trigger, multi-line layout and a
touch-only text property; labels now fade 2 s after release. The Tune-mode
cursor tool reminds users to switch back to it after editing notes.
JUCE aligns the helper calls in its configuration-sequence test, so the
pinned source has seven spaces before (manager) and the four-space anchor
never matched; every dependency fetch failed on macOS, Windows and iPadOS.
…out.md

about.md is embedded as binary data in every build (standalone and plugins).
Headings (#, ##), text and [label](url) links are rendered in the app theme;
links appear as buttons and open in the default browser without showing the
address.
… keeps them; overridable bundle ID and build number
ROOT is derived from the script directory, so from scripts/ it walks up
one level. The Xcode build dir, cmake -S, and the dependency fetchers
still target the repository root.
@W-MS W-MS closed this Oct 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants