/Harpy

Notify users that a new version of your iOS app is available, and prompt them with the AppStore link

Primary LanguageObjective-C

Harpy

Notify users that a new version of your app is available in the AppStore

About

Harpy is a utility that checks a user's currently installed version of your iOS application against the version that is currently available in the AppStore. If a new version is available, an instance of UIAlertView is presented to the user informing them of the newer version, and giving them the option to update the application.

Screenshots

  • The left picture forces the user to update the app.
  • The right picture gives the user the option to update the app.
  • This option is configurable in Harpy.h.

Forced Update Optional Update

Installation Instructions:

  1. Copy the 'Harpy' folder into your Xcode project. The following files will be added:

    1. Harpy.h
    2. Harpy.m
  2. Import Harpy.h into your AppDelegate or Pre-Compiler Header (.pch)

  3. Configure the 5 static variables in HarpyConstants.h

    • You can remove the #warning in Harpy.h after customizing those variables.
  4. In your AppDelegate.m, add [Harpy checkVersion] after calling makeKeyAndVisible:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
	// Customization on application launch
	
	…
	
	// Present Window
	[self.window makeKeyAndVisible]
	
	/*  
		Check AppStore for your application's current version. If newer version exists, prompt user.
		Declare immediatley after you call makeKeyAndVisible on your UIWindow iVar
	*/
	[Harpy checkVersion] 
}

And you're all set!

Important Note on AppStore Submissions

  • As of 2.0.0, no extra configuraiton needs be performed to avoid having the AppStore reviewer see the alert.

Release Notes (v2.0.1):

  • Moved customizable strings to new file, HarpyConstants.h

Contributors

Recognition:

Created by Arthur Ariel Sabintsev