tauri-apps / tauri-apps/tauri-docs
document that iOS and macos devices must be on the same local network for development.
Nobody has claimed this yet.
- Dominant language
- MDX
- Stars
- 1.1k
- Forks
- 887
- Avg merge
- 2d 8h
- Merged PRs (30d)
- 48
Description
Describe the bug
If you run the application in the Xcode Simulator - pnpm tauri ios dev "iPhone 16 Pro", then everything works fine.
But when connecting a physical iPhone by wire and launching pnpm tauri ios dev, the application is successfully builded and installed, but when opened, only a black screen is displayed and nothing more.
After a while, the message "error sending request" appears.
Reproduction
- Install a clean Tauri Vue.js application.
- Launch the application in Xcode Simulator, make sure that everything is working well.
- Set up all sorts of crap like Apple Team ID, certificate, etc.
- Run
tauri ios devon a physical iPhone.
Expected behavior
The app will be displayed on the phone.
Full tauri info output
[✔] Environment
- OS: Mac OS 15.4.1 arm64 (X64)
✔ Xcode Command Line Tools: installed
✔ rustc: 1.87.0 (17067e9ac 2025-05-09)
✔ cargo: 1.87.0 (99624be96 2025-05-06)
✔ rustup: 1.28.2 (e4f3ad6f8 2025-04-28)
✔ Rust toolchain: stable-aarch64-apple-darwin (default)
- node: 24.2.0
- pnpm: 10.10.0
- npm: 11.3.0
[-] Packages
- tauri 🦀: 2.5.1
- tauri-build 🦀: 2.2.0
- wry 🦀: 0.51.2
- tao 🦀: 0.33.0
- @tauri-apps/api : 2.5.0
- @tauri-apps/cli : 2.5.0
[-] Plugins
- tauri-plugin-opener 🦀: 2.3.0
- @tauri-apps/plugin-opener : 2.3.0
[-] App
- build-type: bundle
- CSP: unset
- frontendDist: ../dist
- devUrl: http://localhost:1420/
- framework: Vue.js
- bundler: Vite
[-] iOS
- Developer Teams: *****
Stack trace
Additional context
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the iOS development documentation and the pnpm tauri ios dev entry point, focusing on physical iPhone setup rather than the Xcode Simulator. Verify the reported behavior on a wired device, then document that the iOS and macOS devices must share a local network and explain the resulting connection failure.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- ios, macos
- Domain
- documentation, mobile-dev
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100