Side Loading Studio on iOS Device

Version 1

    Disclaimer Customers wishing to use Studio iOS: Customers are to work on this through Oracle. Wavelink is not responsible for setting up servers nor is it responsible for signing IPAs for customer.

     

    This article describes the process of installing Studio for iOS on a device without Avalanche. Due to how licensing works with Studio we cannot host studio on the ITunes App Store.

    More information can be found within the Documentation provided with the base Wavelink Studio iOS client. Download Wavelink Software for Apple iOS Device Devices

     

    Requirements for success:

    • IPA file that has been signed by end user’s corporate certificate (Wavelink cannot and will not provide this. This cert is the customer’s cert and the customers responsibly)
    • .plist file created for specific IPA file (an example is provided below)
    • Webserver that is reachable by customer’s devices (This falls on the customer’s responsibility. Wavelink does not host or configure servers for customers)

     

    Scenario:

    How to install Studio iOS without Wavelink Avalanche

     

    Components:

    Signing an IPA:

     

    1.    Open a terminal window and navigate to the location of the Studio-Release-

    [version number]-unsigned.ipa file.

     

         2. Run the shell script ldresign_studio.sh with the following command:

    ldresign_studio.sh -a <path to unsigned IPA> -m <path to provisioning profile> -c <name of the certificate> [-114 <path to 114x114 icon> -57 <path to 57x57 icon>]

     

    For example:

     

    ldresign_studio.sh -a "Studio_iOS_unsigned.ipa" -m "My_Studio_Provisioning_Profile.mobileprovision" -c "iPhone Distribution:Company Name Here" -114 "My_Replacement_Icon_114.png" -57 "My_Replacement_Icon_57.png"

     

    The shell script creates Studio-Release-[version number]-resigned.ipa.

     

    If you want to use Studio's default icon images, don't include the references given in the example above. If you want to replace Studio's icons with custom images of your own, you must specify alternate file names for both the 114x114 and 57x57 sizes, located in the same directory as Studio's original icon images.

     

    The plist:

    The Plist is the file that the device will use that the end user will actually download to begin installation of an IPA. The plist is an xml file used by all iOS devices that provide information to the OS. Each IPA will need to have a plist with the exact information of the payload. This means you will need to edit the file location for download, the bundle identifier, bundle version, and title.

     

    Both the plist and the IPA will need to be stored on a webserver that is accessible to the devices that need to be installed. So firewall rules may need to be changed if the networks are blocked between site and server.

    The plist will look like this:

    plist.PNG

     

     

    IOS 7.1 and Higher require hosted files to be accessed via HTTPS:

    Any iOS with an OS of 7.1 or newer requires the use of SSL for the webserver to host files. any standard http traffic to host these files will fail to install.

     

    Further Documentation:

     

    PLIST documentation:

                             https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man5/plist.5.html

                             https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/AboutInformationPropertyListFiles.htm

                Securing IPA

                             https://developer.apple.com/library/prerelease/content/technotes/tn2318/_index.html#//apple_ref/doc/uid/DTS40013777-CH1-TNTAG6

                             https//developer.apple.com/library/prerelease/content/technotes/tn2318/_index.html

     

    Disclaimer: Customers are to work on this through Oracle. Wavelink is not responsible for setting up servers nor is it responsible for signing IPAs for customer.