iPad Won't Launch Course

Aug 29, 2016

I have numerous courses that have been developed for a patient education site. Most of these courses are accessed using iPads at local clinics. I recently updated all of my Storyline courses because many of the iPads went through an iOS update. Everything works fine except one course. The user gets the spinning Articulate wheel and the course never opens. All other courses work fine. I have unpublished and republished. I have deleted and re-added the Articulate player. I am at a loss at this point. Please help me. I have attached the .story file.

Thank you.

31 Replies
Ali Goulet

Hi Adam, 

Thanks for reaching out here! I published your course for web, enabling the Articulate Mobile Player viewing option, and uploaded it to Tempshare to test it in a web environment. I wasn't able to reproduce what you're seeing when testing on an iPad running iOS 9.3.5. Take a look at it here and let me know if you're still seeing that issue. Please note that it's a temporary link and will only be available for 10 days. I've also attached the Published zip file here for you, as well. 

Ali Goulet

Hi Adam- Thanks for the further info on that. The Articulate Mobile Player only supports Tin Can API for LMS. You may be able to view some courses published for SCORM in it, but others may not launch at all. You can read more about that here. I republished your course for LMS using the SCORM option and was able to see what you're describing when I uploaded it to SCORM Cloud to test it. I then republished it using the Tin Can API option instead of SCORM, and it launched and played as expected in the Articulate Mobile Player after uploading it to SCORM Cloud. You can view it here. 

Although this wasn't an issue with your LMS, I just wanted to share this article on How to Troubleshoot Your LMS Using SCORM Cloud so you have it handy. I find it to be really helpful when assessing whether an issue is file specific or LMS specific. :)

Stacie Linn

right click on the published file...story.html and open in either Dreamweaver or Notepad ++ and paste this code on line 13...save and zip and upload to your server.  It bypasses the articulate app and allows you to open on mobile devices.  Before you publish make sure the articulate app box is unchecked.

paste on line 13...

  /* -----------start Neil's code ---------------*/
  // This code detects iPad and skips the App install request.
  var viPad = (navigator.userAgent.indexOf("iPad") > -1);
  var viPhone = (navigator.userAgent.indexOf("iPhone") > -1);
  if(viPad || viPhone){document.location.href='story_html5.html';}
  /* -----------end Neil's code ---------------*/

Ali Goulet

Thanks for sharing here, Stacie!

Adam- I can't speak to whether the method shared by Stacie works, as it's making edits to the published output which is something we can't support. I wasn't able to reproduce the error you're receiving from you LMS when uploading the Tin Can published version in SCORM Cloud, so that may be something you'll have to reach out to your LMS for.

I was, however, able to reproduce the issue of it not launching published for SCORM even after unselecting the option to view on Articulate Mobile Player. Since this seemed file specific, I imported your slides into a new file and was able to have it launch successfully on the iPad. However, once I also imported your player settings it would no longer launch.

I've created a case on your behalf with our Support Engineers (case 00879961) and escalated it immediately so they can assist further with investigating the issue. They'll be reaching out to you shortly via email. I'll follow along and relay information here for anyone that may find it helpful. :)

Ali Goulet

Hi Adam,

I'm also having trouble with that zip file. I wasn't able to successfully upload your zip into SCORM Cloud. When I republished your course for Tin Can myself, I was able to upload it. I've attached that zip file here for you to try.

The issue you're seeing with the manifest missing usually comes from the file being zipped improperly. If you're using the zip option in the Published Successful window, however, this isn't expected behavior- it should create a well-formed zip file for you. I'm wondering if it could either be an issue with antivirus interfering with the file or possibly an issue with the software itself. I would recommend republishing again and zipping it using the option in the Publish Successful Window. Keep an eye out if you get any alerts or messages from any AV software you may have. If not, and the issue persists, I would suggest running a repair on your software

Ali Goulet

Hi Adam,

Since the zip file I sent had the manifest in it on my end, I'm leaning toward the cause being AntiVirus software interfering with the file on your computer. Are you using a company computer or a personal one? If the former is the case, I would suggest reaching out to your IT Team to see if they could temporarily disable your AV software.

Justin Grenier

Good Morning, Adam.

Different LMS protocols have different requirements around the structure of the published output:

  • For SCORM 1.2 and SCORM 2004, we place an imsmanifest.xml file at the root of the published output.
  • For Tin Can API, we place a tincan.xml file at the root of the published output.
  • The AICC protocol doesn't require any manifest at all, so we won't create one.

In other words, the screenshot above shows the correct file structure of a published Tin Can course.  Your LMS should not require an imsmanifest.xml file for e-learning content published using the Tin Can API protocol.  The full specification of the Tin Can protocol is detailed here if you need a little light reading.  :)

Please let us know if you need anything else, and have a great day!

Lauren Connelly

Hi Chandan!

Thank you so much for attaching your file! I'm happy to help.

Here are two troubleshooting steps to get us started:

  • First, how are you publishing the file? For Web, Video, or LMS?
  • Are you viewing the course in Chrome or Safari on the iPad?

It would be helpful if you could keep me updated in this discussion so that I can test your course in the exact environment that you're using.

P.S. iPads don't support anything that relies on Flash. You'll want to make sure to publish using the HTML5 Format.

Katie Riggio

Hi Chandan. Thanks for those details!

Here's a recap of my testing:

  1. I published the file for LMS with HTML5-only using Storyline 360 Update 39 and then hosted the output on SCORM Cloud, an industry-standard testing tool. You can view the course through this link ⤶
  2. I viewed the link above on an iPad 7th iOS 13/Chrome where the course looks great. You can see the behavior in this recording ⤶

How does the course look on your iPad when you test my link?

Jeremy Boehl

Hello, we are seeing this issue too - courses are not launching on iPad in our vendor mobile app (SumTotal mobile). However, the same courses launch in all web browsers and they launch with the mobile app on the iPhone. We have reproduced it on iPad OS 13 and above.

This issue is observed when the SCORM Course is launched in a WebView on iPad (WKWebView). This is due to ds-bootstrap.min.js evaluating a faulty regular expression to determine the OS Version. Line :parseInt((/os ([0-9]+)_/.exec(g)||/version\/([0-9]+)/.exec(g))[1]) When built with XCode 11, WKWebView's UserAgent defaults to mozilla/5.0 (macintosh; intel mac os x 10_15) applewebkit/605.1.15 (khtml, like gecko) and throws a null exception. ds-bootstrap version where the issue is reproducible: v1.0.0.987

Is there any Publish option that would prevent this file from being referenced in the Package? Or are there any plans to update to include newer ds-bootstrap versions that might have a fix for this? Thank You

This discussion is closed. You can start a new discussion or contact Articulate Support.