About the Download

Ti.SplashScreen is an iOS Hyperloop wrapper of the CBZSplashView library.

It provides an easy way to replicate what Twitter does after opening the app. It’s an animated view you can use anywhere you want (Button clicks, after opening you app, after some process…)

The module gets an image and a background color you chose and create a nice animation to show both.

Demo running with Hyperloop

2016-12-09-15_44_41

 

README

These instructions are being shipped with the module, so you can check later on your README file.

LoopModules – Ti.SplashScreen

This HyperLoop module is a wrapper of the CBZSplashView module.
The module gets an image and a background color you chose and create a nice animation to show both.

1 – Requirements

This project uses HyperLoop. We recommend you to read the basics of HyperLoop in the links below before proceeding any further in this README.
iOS: Hyperloop_for_iOS-Programming_Guide
Android: Hyperloop_for_Android_Programming_Guide

HyperLoop does a pretty good job in allowing you to use Objective-C / Swift with Javascript syntax, but that doesn’t mean that you won’t need to learn Objective-C / Swift if you want to customise the module / create your own. For that reason we highly recommend you to learn the basics of Objective-C / Swift.
In the long run that will make your job easier, since Objective-C is far from being an easy language to understand at the first sight.

2 – Environment setup

This module was tested and developed with the following environment:

  • CocoaPods 1.0.1
  • Titanium SDK 6.0.0.GA
  • HyperLoop 2.0.0
  • XCode 8.1

3 – Creating a HyperLoop-enabled project

  • Create a new Alloy project like you would normally do. (Don’t forget to a hyperloop-enabled project)
  • Take a look at the example tiapp.xml file that you’ve received from us. Your tiapp.xml should have the same properties defined in this example
    otherwise you’ll face some issues while building your project later on.
    Don’t forget to change the App GUID in the provided tiapp.xml file to your original App GUID!
  • Copy the controller, view files + the “libs” folder provided with this module to your project’s “/app” folder.
  • Copy the Podfile, appc.js file and the “src” folder to the root of your project

4 – Usage

You’ll find inside this zip a very simple example of controller that you can copy to your HyperLoop-enabled project and start playing with it.
It’s pretty straightforward to use this module, you just have to create a new instance of the HL_SplashScreen lib and use the following function:

HL_SplashScreen.createAnimatedSplashScreen(view, 'appc-logo.png', '#C60B2B');

You can use this function wherever you want (Button clicks, after opening the app…)

After following all the steps above you should have the project up and running without any problems.
HyperLoop DOES NOT work with LiveView as of now, so you will need to rebuild your project every time you change anything.

Support

One of the things we want to offer you as a reward for joining LoopModules is the ability to contact us to discuss and get help with problems that you may come across.
We’ve tested this module a lot of times and we want to deliver something that will work for everyone (as long as the environments are the same, e.g. SDK, HL version, and so on).
If you come across one of the following:

  • Bugs
  • Suggestions
  • Issues while compiling this module

Feel free to contact us at contact@loopmodules.com.