功能說明
First, which one is it?
| What you see | Usually | What is left behind |
|---|---|---|
| The app suddenly disappears to the Home Screen | Crash | The system may later leave “Crash and Hang Reports” |
| The screen stops responding, then recovers or is closed by the system | Freeze (hang) | The system may leave a hang report |
| After playing in the background for a while the app is gone, with no obvious error | Ended by the system (for example low memory) | Not always a crash report; “Runtime Metrics” may show an exit reason |
| The app stays stuck while starting | Launch failure | Next time you open it you will see “The last launch did not finish” |
| One action fails but the app keeps running | Ordinary error | Only the log |
Get going again
- Quit the app completely and open it again.
- If you see “The last launch did not finish”, tap “Copy Diagnostics” and send the text to the author. On iPhone and iPad the same information is also saved in the Files app under Primuse → Diagnostics. On a Mac the notice is “Primuse didn't finish launching last time” with “Copy Details”.
- On iPhone and iPad, if two launches in a row don't finish, the app starts in “Safe Mode” and temporarily skips the Home screen and entrance animations, restoring the last playback session, iCloud sync and background scanning, and library-wide recommendations and the folder index. The Mac has no Safe Mode. Send the diagnostics first, then tap “Resume Normal Launch”; the next launch opens the Home screen as usual.
- If the problem only happens with one song, source or action, avoid it for now and note which one.
Collect information
- Open Settings → About → “Diagnostic Reports” and turn on “Record Detailed Logs” (source code 1.12.2 and later).
- Repeat the action that causes the problem and note the approximate time.
- Crash and hang reports usually appear under “Crash and Hang Reports” only after you open the app again, and can take a while.
- Upload or send them as described in Collect and send diagnostics to the author, and include in your message:
- device model, system version and app version;
- what you did just before, on which screen, with which kind of music source;
- whether it crashed, froze or was closed, and roughly when;
- whether you can make it happen again reliably.
Known limits
- Apple TV has no system crash and hang reports; only the log and your description are available.
- Apple Watch has no diagnostics screen; report from the paired iPhone.
- Reports on the device are kept for about 7 days, so send them soon.
Related articles
問題原因
Crashes and freezes can have many causes, for example unusual data in a file or music source, the system ending the app when memory is low, or a network request that never answers. A crash report or a single error line is a clue, not necessarily the root cause; the author needs your description of what you did and when to judge it.