Upgrading to the Google+ iOS SDK v1.7.1

If you wish to upgrade to the latest version (1.7.1), you will need to modify your Xcode project to migrate to the latest version.

Upgrading from version 1.5.1 to 1.7.1

Upgrading from 1.5.1 to 1.7.1 requires downloading the new SDK and adding an extra framework to your Xcode project. Note that v1.7.1 requires iOS 6 or later.

  1. Download the latest SDK.

  2. Copy the new versions of the Google+ frameworks and bundle into your project:

    • GooglePlus.framework
    • GoogleOpenSource.framework
    • GooglePlus.bundle

Upgrading from version 1.4.x to 1.7.1

Upgrading from 1.4.0 or 1.4.1 to 1.7.1 requires downloading the new SDK and adding an extra framework to your Xcode project. Note that v1.7.1 requires iOS 6 or later.

  1. Download the latest SDK.

  2. Copy the new versions of the Google+ frameworks and bundle into your project:

    • GooglePlus.framework
    • GoogleOpenSource.framework
    • GooglePlus.bundle
  3. Include the following iOS framework:

    • AddressBook.framework

Upgrading from version 1.3.0 to 1.7.1

Upgrading from version 1.3.0 to 1.7.1 requires downloading the new SDK, including new frameworks in your Xcode project, optionally modifying your share dialog code to use the new native share dialog, and rebuilding your project.

If you are upgrading from an earlier version, see upgrading from v1.2.0 or earlier then refer to this section to complete the migration.

  1. Download the latest SDK.

  2. Copy the new versions of the Google+ frameworks and bundle into your project:

    • GooglePlus.framework
    • GoogleOpenSource.framework
    • GooglePlus.bundle
  3. Include the following iOS frameworks:

    • AddressBook.framework
    • AssetsLibrary.framework
    • Foundation.framework
    • CoreLocation.framework
    • CoreMotion.framework
    • CoreGraphics.framework
    • CoreText.framework
    • MediaPlayer.framework
    • UIKit.framework
  4. Optional: If you want to use the new native share dialog, your share builder from GPPShareBuilder to GPPNativeShareBuilder, for example:

    Find:

    id<GPPShareBuilder> shareBuilder = [[GPPShare sharedInstance] shareDialog];
    

    Replace with:

    id<GPPNativeShareBuilder> shareBuilder = [[GPPShare sharedInstance] nativeShareDialog];
    

    The native share dialog requires that your app uses Google+ Sign-In and supports new features such as uploading media as part of your posts. For more information, see sharing.

  5. Build your project!

Upgrading from version 1.2.0 or earlier to 1.3.0

  1. Remove old files. You must remove the following files:

    • GPPDeepLink.h
    • GPPShare.h
    • GPPSignin.h
    • GPPSignInButton.h
    • GPPURLHandler.h
    • libGooglePlus.a
    • libGooglePlusUniversal.a
  2. Remove the files that were added from the OpenSource and Resources directories:

    • OpenSource/GTL/*
    • OpenSource/GTM*
    • OpenSource/OpenInChromeController.h
    • OpenSource/OpenInChromeController.m
    • Resources/*.proj/GooglePlusPlatform.strings
    • Resources/gpp_*
  3. Update your import statements. Version 1.7.1 consolidates the headers to reduce the number of imports that you define.

    Replace:

    • #import “GPPSignIn.h”
    • #import “GPPShare.h”
    • #import “GPPDeepLink.h”
    • #import “GPPSignInButton.h”
    • #import “GPPURLHandler.h”

    With:

    #import <GooglePlus/GooglePlus.h>

  4. Update the imports for the headers from the open source directory.

    Replace:

    • #import “GTLPlus/GTLPlus.h”
    • #import “GTLPlus/GTLPlusMoment.h”
    • #import “GTLPlus/GTLPlusConstant.h”
    • #import “GTLPlus/GTLPlusItemScope.h”
    • #import “GTLPlus/GTLQueryPlus.h”
    • #import “GTLPlus/GTLServicePlus.h”

    With:

    #import <GoogleOpenSource/GoogleOpenSource.h>

  5. Upgrade the SDK with the latest files

    1. Download the latest Google+ iOS SDK

    2. In the previous steps, you updated your headers and removed old files. Now you must include the new framework and bundle files. In Step 3. Initialize the Google+ Client, follow steps 1-3 to update your project with the new files.

    3. Build!

Send feedback about...

Google+ Platform for iOS
Google+ Platform for iOS