ILink

Purpose

Different iOS/OS-X versions require different link building for rating or sharing the app, for developer profile etc. iLink is the library that would do all this for you at run time with almost no setup (no need to set up the Apple ID of the app or any details about developer account). This library would also prompt the user to update the app if there is a newer version on the App Store (optional). Also, can initiate a local notification if there is an update (background fetch). Works both on iOS & Mac OS-X, Just drop the 2 files of the library directly to your project and use the methods to open the app page or developer page without setting up anything beforehand.

Please check the Example apps (iOS/Mac) for fast integration.

Supported OS & SDK Versions

• Supported build target - iOS 11.2.5 / Mac OS 10.12.6 (Xcode 9.2, Apple LLVM compiler 9.0)
• Earliest supported deployment target - iOS 8.0 / Mac OS 10.12

NOTE: 'Supported' means that the library has been tested with this version. 'Compatible' means that the library should work on this OS version (i.e. it doesn't rely on any unavailable SDK features) but is no longer being tested for compatibility and may require tweaking or bug fixes to run correctly.

ARC Compatibility

iLink requires ARC. If you wish to use iLink in a non-ARC project, just add the -fobjc-arc compiler flag to the iLink.m class. To do this, go to the Build Phases tab in your target settings, open the Compile Sources group, double-click iLink.m in the list and type -fobjc-arc into the popover.

If you wish to convert your whole project to ARC, comment out the #error line in iLink.m, then run the Edit > Refactor > Convert to Objective-C ARC... tool in Xcode and make sure all files that you wish to use ARC for (including iLink.m) are checked.

Thread Safety

iLink uses threading internally to avoid blocking the UI, but none of the iLink external interfaces are thread safe and you should not call any methods or set any properties on iLink except from the main thread.

Installation

To install iLink into your app, drag the iLink.h, .m into your project.

You could also use cocoapods (recommended) by adding this line to your podfile:

pod 'iLink', '~> 1.1.0'

Important: Currently the pod works only for iOS (we stopped supporting OS-X because of cocoapods bug). You can use 1.0.5 for OS-X (not supporting local notifications on iOS) or import the library manually.

iLink typically requires no configuration at all and will simply run automatically, using the application's bundle ID to look the app ID up on the App Store.

Note: If you have apps with matching bundle IDs on both the Mac and iOS app stores (even if they use different capitalisation), the lookup mechanism won't work, so you'll need to manually set the appStoreID property, which is a numeric ID that can be found in iTunes Connect after you set up an app. Also, if you are creating a sandboxed Mac app and your app does not request the network access permission then you will need to set the appStoreID because it cannot be retrieved from the iTunes service.

If you do wish to customise iLink, the best time to do this is before the app has finished launching. The easiest way to do this is to add the iLink configuration code in your AppDelegate's initialize method, like this:

#import "iLink.h"

+ (void)initialize
{
	//configure iLink
	[iLink sharedInstance].globalPromptForUpdate = YES; // If you want iLink to automatically prompt user to update when there is an update. Otherwise just set it to "NO".
}

Methods

iLink is used to open App page, developer profile or rating page for the app using the following methods:

--- App Links

- (void)iLinkOpenAppPageInAppStore;  

This method would open the app page in the appropriate way in the Mac or iPhone app store, depending on which platform iLink is running on. Important is that this would open the store directly without opening safari first.

- (NSURL *)iLinkGetAppURLforLocal; 

This method would create the relevant URL for locally open the app store (it is recommended to use iLinkOpenAppPageInAppStore to open the store and not getting the link). Use this if you want to open that inside the app manually.

- (NSURL *)iLinkGetAppURLforSharing; 

This method would create the appropriate link to share on social networks/email etc. Use this if you want to share the link outside the app.

- (void)iLinkOpenAppPageInAppStoreWithAppleID:(NSUInteger)appStoreIDtoOpen; 

This method would create the appropriate link to the app with Apple ID appStoreIDtoOpen. Use this to open another specific app for example the paid version or any reference to other app. Code would recognize if it's an iOS app or Mac app. But pay attention to send the right ID to each app (there isn't same Apple ID for Mac&iOS app for time of writing so you would need to check that if your code support both).

--- Developer Links

- (void)iLinkOpenDeveloperPage;

This method would open the developer page in the appropriate way in the Mac or iPhone app store, depending on which platform iLink is running on. Important is that this would open the store directly without opening safari first.

- (NSURL *)iLinkGetDeveloperURLforLocal; 

Use this method if you want to open the Developer URL by yourself and not by using iLinkOpenDeveloperPage method for example if you want to open that page inside the app.

- (NSURL *)iLinkGetDeveloperURLforSharing; 

This method return the URL for the developer profile in the best way for sharing. Use this if you want to share the link outside the app (for example on social networks).

--- Rating Links

- (void)openRatingsPageInAppStore;

This method opens the application ratings page in the Mac or iPhone app store, depending on which platform iLink is running on. This method does not perform any checks to verify that the machine has network access or that the app store is available. It also does not call the -iLinkShouldOpenAppStore delegate method. You should use this method to open the ratings page instead of the ratingsURL property, as the process for launching the app store is more complex than merely opening the URL in many cases. Note that this method depends on the appStoreID which is only retrieved after polling the iTunes server. If you call this method without first doing an update check, you will either need to set the appStoreID property yourself beforehand, or risk that the method may take some time to make a network call, or fail entirely. On success, this method will call the -iLinkDidOpenAppStore delegate method. On Failure it will call the -iLinkCouldNotConnectToAppStore: delegate method.

- (NSURL *)iLinkGetRatingURL;

This method returns the relevant URL for rating the current app (if you have something smart to do with it).

Configuration

To configure iLink, there are a number of properties of the iLink class that can alter the behaviour and appearance of iLink. These should be mostly self- explanatory, but they are documented below:

@property (nonatomic, assign) BOOL globalPromptForUpdate;

This would set if iLink would automatically check if there is an update for the app on iTunes and prompt the user to update. Default is set to YES meaning iLink would automatically ask the user to update if there is an update for the app, prompt would include a reminder of 1 day (after user press "Remind me later").

@property (nonatomic, assign) BOOL aggressiveUpdatePrompt;

This would set if iLink would automatically check if there is an update for the app on iTunes and prompt the user to update always. Default is set to NO, if set to YES meaning iLink would automatically ask the user to update if there is an update for the app, prompt would include only "Update NOW!" option (user WON'T be able to access the app without updating). Use this option carefully.

@property (nonatomic, assign) NSUInteger appStoreID;

This should match the iTunes app ID of your application, which you can get from iTunes connect after setting up your app. This value is not normally necessary and is generally only required if you have the aforementioned conflict between bundle IDs for your Mac and iOS apps, or in the case of Sandboxed Mac apps, if your app does not have network permission because it won't be able to fetch the appStoreID automatically using iTunes services.

@property (nonatomic, copy) NSString *appStoreCountry;

This is the two-letter country code used to specify which iTunes store to check. It is set automatically from the device locale preferences, so shouldn't need to be changed in most cases. You can override this to point to the US store, or another specific store if you prefer, which may be a good idea if your app is only available in certain countries.

@property (nonatomic, copy) NSString *applicationName;

This is the name of the app displayed in the iLink alert. It is set automatically from the application's info.plist, but you may wish to override it with a shorter or longer version.

@property (nonatomic, copy) NSString *applicationBundleID;

This is the application bundle ID, used to retrieve the appStoreID and appStoreGenreID from iTunes. This is set automatically from the app's info.plist, so you shouldn't need to change it except for testing purposes.

@property (nonatomic, assign) float remindPeriod;

How long the app should wait before reminding a user to update after they select the "remind me later" option (measured in days). A value of zero means the app will remind the user next launch. Note that this value supersedes the other criteria, so the app won't prompt for an update during the reminder period, even if a new version is released in the meantime. This defaults to 1 day.

@property (nonatomic, copy) NSString *messageTitle;

The title displayed fo