I'd like to show Onboard at first time launch, but right now nothing appears. This is my code:

#import "OnboardingViewController.h"
@interface ViewController ()

@implementation ViewController
#
#
#
-(void)firstTimePopup{

    OnboardingContentViewController *firstPage = [OnboardingContentViewController contentWithTitle:@"Welcome" body:@"body." image:[UIImage imageNamed:@"logo"] buttonText:@"Text For Button" action:^{
    }];
    OnboardingContentViewController *secondPage = [OnboardingContentViewController contentWithTitle:@"Welcome" body:@"body." image:[UIImage imageNamed:@"logo"] buttonText:@"Text For Button" action:^{
    }];
    OnboardingViewController *onboardingVC = [OnboardingViewController onboardWithBackgroundImage:[UIImage imageNamed:@"bg"] contents:@[firstPage, secondPage]];
    [self presentViewController:onboardingVC animated:YES completion:nil];
end

what am I missing?

After update to Xcode 8 I got this crash.

*** Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '-[_SwiftValue setDelegate:]: unrecognized selector sent to instance 0x60000024d9b0' *** First throw call stack: (

0   CoreFoundation                      0x000000010f03a34b __exceptionPreprocess + 171
1   libobjc.A.dylib                     0x000000010ea5521e objc_exception_throw + 48
2   CoreFoundation                      0x000000010f0a9f34 -[NSObject(NSObject) doesNotRecognizeSelector:] + 132
3   CoreFoundation                      0x000000010efbfc15 ___forwarding___ + 1013
4   CoreFoundation                      0x000000010efbf798 _CF_forwarding_prep_0 + 120
5   Onboard                             0x000000010df85289 -[OnboardingViewController generateView] + 2121
6   Onboard                             0x000000010df83f7b -[OnboardingViewController viewDidLoad] + 171
7   UIKit                               0x000000010faa306d -[UIViewController loadViewIfRequired] + 1258
8   UIKit                               0x000000010faa34a0 -[UIViewController view] + 27
9   UIKit                               0x000000010f96d045 -[UIWindow addRootViewControllerViewIfPossible] + 71
10  UIKit                               0x000000010f96d796 -[UIWindow _setHidden:forced:] + 293
11  UIKit                               0x000000010f9810a9 -[UIWindow makeKeyAndVisible] + 42
12  UIKit                               0x000000010f8fa259 -[UIApplication _callInitializationDelegatesForMainScene:transitionContext:] + 4818
13  UIKit                               0x000000010f9003b9 -[UIApplication _runWithMainScene:transitionContext:completion:] + 1731
14  UIKit                               0x000000010f8fd539 -[UIApplication workspaceDidEndTransaction:] + 188
15  FrontBoardServices                  0x00000001142e976b __FBSSERIALQUEUE_IS_CALLING_OUT_TO_A_BLOCK__ + 24
16  FrontBoardServices                  0x00000001142e95e4 -[FBSSerialQueue _performNext] + 189
17  FrontBoardServices                  0x00000001142e996d -[FBSSerialQueue _performNextFromRunLoopSource] + 45
18  CoreFoundation                      0x000000010efdf311 __CFRUNLOOP_IS_CALLING_OUT_TO_A_SOURCE0_PERFORM_FUNCTION__ + 17
19  CoreFoundation                      0x000000010efc459c __CFRunLoopDoSources0 + 556
20  CoreFoundation                      0x000000010efc3a86 __CFRunLoopRun + 918
21  CoreFoundation                      0x000000010efc3494 CFRunLoopRunSpecific + 420
22  UIKit                               0x000000010f8fbdb6 -[UIApplication _run] + 434
23  UIKit                               0x000000010f901f34 UIApplicationMain + 159
24  FirstCard                           0x000000010bbe9d3f main + 111
25  libdyld.dylib                       0x0000000111b3268d start + 1
26  ???                                 0x0000000000000001 0x0 + 1

)

Here is the code that I use to create Onboarding in AppDelegate.swift

` func generateOnBoardViewController()-> OnboardingViewController { print("(#function)") // Initialize onboarding view controller // var onboardingVC = OnboardingViewController() let icon = UIImage(named: "empty-biz") let firstPage = OnboardingContentViewController.content(withTitle: "Welcome", body: "Welcome message", image: icon, buttonText: nil) { }

    let secondPage = OnboardingContentViewController.content(withTitle: "Hello", body: "Body", image: icon, buttonText: nil) {
    }
    let thirdPage = OnboardingContentViewController.content(withTitle: "Start now.", body: "Sign up now it's easy.", image: icon, buttonText: nil) {
        self.switchToSignupOrLoginViewControllers()
    }

    let bg = UIImage(named: "onboard-bg")
    let onboardingVC = OnboardingViewController.init(backgroundImage: bg, contents: [firstPage, secondPage, thirdPage])
    return onboardingVC!

}`

Then I check if user is login, if not replace the rootViewController with this code

self.window?.rootViewController = generateOnBoardViewController()

I have try so many init method of OnboardingViewController but none of them works. Any suggestion?

I made some changes to the action blocks. I know these are breaking changes, but with autocomplete it shouldn't be too big of an update for existing users. If this looks good I can make the necessary updates to the README file as well.

The idea here is to pass a reference to self in the action block, so the handler can do things like skip to the next page. Here is an example of the desired usage:

OnboardingContentViewController *page = [OnboardingContentViewController contentWithTitle:@"Page Title" body:@"Page body goes here." image:[UIImage imageNamed:@"icon"] buttonText:@"Text For Button" action:^(OnboardingContentViewController *onboardingContentController) {
    // start some long async process

    // show progress HUD or something

    // all done and everything succeeded, ready to move on
    [onboardingContentController moveNextPage];
}];

This allows for a bit more control than just the movesToNextViewController property.

Hi Mike, here again my problem :) As I already mention in my email I can't really figure out, how to add this amazing project into mine. I´m using Storyboards and I would like to add my firstViewController after your "Skip" / "Lets Start" Buttons.... I saw in Code some hint, but for me it´s like a Wormhole (full of mysteries and questions) :)

Here your code:

- (void)setupNormalRootViewControllerAnimated:(BOOL)animated {
    // create whatever your root view controller is going to be, in this case just a simple view controller
    // wrapped in a navigation controller
    UIViewController *mainVC = [UIViewController new];
    mainVC.title = @"Main Application";

    // if we want to animate the transition, do it
    if (animated) {
        [UIView transitionWithView:self.window duration:0.5 options:UIViewAnimationOptionTransitionCrossDissolve animations:^{
            self.window.rootViewController = [[UINavigationController alloc] initWithRootViewController:mainVC];
        } completion:nil];
    }

    // otherwise just set the root view controller normally without animation
    else {
        self.window.rootViewController = [[UINavigationController alloc] initWithRootViewController:mainVC];
    }

I´ve added an new ViewController to the SB and tried to Link it to UIViewController *mainVC but it hasn't worked.... To understand how it could works, i also add an blank Storyboard to your project and I´ve tried to build it up with an new ViewController and so on, but without any results.

I would be very thankful for your help. With best regards and happy holidays

Adam

would you mind to enhance the Swift example so it shows the full implementation of the capabilities. Newbies like me struggle with stuff such as the action button, which does not currently work. Thx!

For example: how can I get tp my initial rootViewController created in my Storboard?

let thirdPage: OnboardingContentViewController = OnboardingContentViewController(title: "second Page", body: "on second page...", image: UIImage(named: "yellow"), buttonText: "Let's Get Started") {

            //let mainStoryboard: UIStoryboard = UIStoryboard(name: "loginVC", bundle: nil)
            let loginView: VCLogin = VCLogin(nibName: "loginVC", bundle: nil)
            self.window?.makeKeyAndVisible()
            self.window?.rootViewController?.presentViewController(loginView, animated: true,   completion: nil)      
    }

the above code does not work

BTW: great work!

I used Onboard a couple of times without worries. Today I ran into a very weird bug : a view is not rendered (it is blank, but if I click were the button is supposed to be, it starts working again). If I allow swiping, it works. But not if I move to the next page programmatically.

I can't put the code (too big?) but it's pretty straightforward : I execute moveToNextPage() on each button action.

Thanks

Any way to implement Landscape mode?

Alternatively, how would I "wrap it in a subclassed UINavigationController that only supports portrait"

In iOS 9.3 and iOS 10 you need to request user access when calling any Media APIs. Since many people use on boarding to explain and request this access this poses a problem. Simply loading the Onboard framework causes ios10 to prompt for access to the library. This means that the prompt appears before the on boarding screen designed to request this access.

This ruins the on boarding experience unfortunately and will make this an unusable solution for many

The environment：iOS7.1+iphone4s *** Assertion failure in -[_UIQueuingScrollView _replaceViews:updatingContents:adjustContentInsets:animated:], /SourceCache/UIKit/UIKit-2935.138/_UIQueuingScrollView.m:383 2015-06-08 18:00:08.856 Onboard[442:60b] *** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Invalid parameter not satisfying: [views count] == 3' *** First throw call stack: (0x2d88cf83 0x3803dccf 0x2d88ce5d 0x2e23ad5b 0x3060ab99 0x3060da75 0x3060a1a9 0x300a9d59 0x2fd2762b 0x2fd22e3b 0x2fd22ccd 0x2fd226df 0x2fd224ef 0x2fd1c21d 0x2d858255 0x2d855bf9 0x2d855f3b 0x2d7c0ebf 0x2d7c0ca3 0x326c6663 0x3010d14d 0x996d1 0x3854aab7) libc++abi.dylib: terminating with uncaught exception of type NSException。

Some helpful information online： http://stackoverflow.com/questions/14220289/removing-a-view-controller-from-uipageviewcontroller http://stackoverflow.com/questions/20004310/invalid-parameter-exception-thrown-by-uiqueuingscrollview

Hey,

Great work with this library!

Is it possible to use a video as background instead of a photo? Something like a video looping would be really cool with both mask + blur applied.

Hey mamaral, Incredible work with the framework, but i can't understand exactly what i should do after importing the "Onboard" with cocoapods. Can you explain it a little bit more? So i create a class and i put the first line of code there after that i make the VC and i "connect" the .swift file with the VC. The conclusion is that i think that you could think and write the whole process more analytical etc. It will help a lot of people. It's an awesome framework!

Using Onboard I saw that skip button text was not vertically centralized in the page control as in the bellow image.

after some digging I could see it is because PageController and SkipButton does not have the same height as you can see bellow.