Skip to content

Problems and Debugging

Davide Casali edited this page Oct 28, 2013 · 12 revisions

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 will contain the bugfix you need.
  6. Validate all your JSON files with JSONLint. This includes your book.json files and your shelf.json if you're using Newsstand Mode.
  7. If it's a problem with the HTML, test if it works on Mobile Safari first.
  8. If it's a problem with iTunes Purchases / Subscriptions, please be aware that from iOS7 you can just test it from the device. Doesn't work on the simulator.
  9. 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 back in the issue the following details:

  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, Subscriptions, etc) we can't help and we will ask you to use Stack Overflow or Apple's Developer Forums.