Problems and Debugging

Of course, the idea is that nothing weird should happen and the whole community works to achieve that. But we all know, sometimes problems arise.

Step by step guide

Here's a step-by-step guide that might help you.

1. Do a Proper cleanup
2. Check that Baker is the last official released version on the website
3. Check that you're using the latest version of XCode.
4. Try downloading a clean version from the website and updating just the publication, to see if it works.
5. If it still doesn't work, try testing the MASTER version from GitHub: while it's not considered stable, sometimes it solves the issue.
6. If you are using Newsstand mode and books don't show up, check shelf.json with JSONLint.
7. If it's a problem with the HTML, test if it works on Mobile Safari first.
8. Delete the app from the simulator/device and re-run.

 

 

No luck... what should I do then?

If everything fails, then the best idea is to report a bug or ask the community on the Issues page above. When you do that, please write in the issue:

1. Version — The Baker version you're using.
2. Steps — Detail all the steps required for us to reproduce the problem reliably. Be as detailed as possible.
3. Log — Include the full debug log (Xcode -> Debug panel, copy and paste).
4. Screenshots — If relevant to the issue, add screenshots.
5. Try to explain if it's a problem with Baker or with the page HTML.
6. Add any other detail that might be useful to track the problem.

Please allow a few days to reply. While we are fast - sometimes lightning fast - that's not always the case.

Remember that if it's a problem on Apple's side (Xcode, iTunes Connect, etc) we can't help and we will ask you to use Stack Overflow or Apple's Developer Forums.