Skip to content

Commit

Permalink
v3.5.0
Browse files Browse the repository at this point in the history
  • Loading branch information
djih committed Jan 15, 2016
1 parent bb6f620 commit 8e81f63
Show file tree
Hide file tree
Showing 4 changed files with 11 additions and 5 deletions.
4 changes: 2 additions & 2 deletions Amplitude-iOS.podspec
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
Pod::Spec.new do |s|
s.name = "Amplitude-iOS"
s.version = "3.4.1"
s.version = "3.5.0"
s.summary = "Amplitude mobile analytics iOS SDK."
s.homepage = "https://amplitude.com"
s.license = { :type => "MIT" }
s.author = { "Amplitude" => "dev@amplitude.com" }
s.source = { :git => "https://github.com/amplitude/Amplitude-iOS.git", :tag => "v3.4.1" }
s.source = { :git => "https://github.com/amplitude/Amplitude-iOS.git", :tag => "v3.5.0" }
s.platform = :ios, '5.0'
s.source_files = 'Amplitude/*.{h,m}'
s.requires_arc = true
Expand Down
2 changes: 1 addition & 1 deletion Amplitude/AMPConstants.m
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

NSString *const kAMPLibrary = @"amplitude-ios";
NSString *const kAMPPlatform = @"iOS";
NSString *const kAMPVersion = @"3.4.1";
NSString *const kAMPVersion = @"3.5.0";
NSString *const kAMPEventLogDomain = @"api.amplitude.com";
NSString *const kAMPEventLogUrl = @"https://api.amplitude.com/";
const int kAMPApiVersion = 3;
Expand Down
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
## Unreleased

## 3.5.0 (January 15, 2016)

* Add ability to clear all user properties.

## 3.4.1 (December 31, 2015)
Expand Down
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ A [demo application](https://github.com/amplitude/iOS-Demo) is available to show
# Setup #
1. If you haven't already, go to https://amplitude.com and register for an account. You will receive an API Key.

2. [Download the source code](https://github.com/amplitude/Amplitude-iOS/archive/master.zip) and extract the zip file. Alternatively, you can pull directly from GitHub. If you use CocoaPods, add the following line to your Podfile: `pod 'Amplitude-iOS', '~> 3.4.1'`. If you are using CocoaPods, you may skip steps 3 and 4.
2. [Download the source code](https://github.com/amplitude/Amplitude-iOS/archive/master.zip) and extract the zip file. Alternatively, you can pull directly from GitHub. If you use CocoaPods, add the following line to your Podfile: `pod 'Amplitude-iOS', '~> 3.5.0'`. If you are using CocoaPods, you may skip steps 3 and 4.

3. Copy the `Amplitude` sub-folder into the source of your project in XCode. Check "Copy items into destination group's folder (if needed)".

Expand Down Expand Up @@ -235,7 +235,11 @@ In either case, you can call Amplitude methods with `Amplitude.instance().method
This SDK automatically grabs useful data from the phone, including app version, phone model, operating system version, and carrier information.

### Location Tracking ###
If the user has granted your app location permissions, the SDK will also grab the location of the user. Amplitude will never prompt the user for location permissions itself, this must be done by your app. Amplitude only polls for a location once on startup of the app, once on each app open, and once when the permission is first granted. There is no continuous tracking of location, although you can force Amplitude to grab the latest location by calling `[[Amplitude instance] updateLocation]`. Note this does consume more resources on the user's device, so use this wisely. If you wish to disable location tracking done by the app, you can call `[[Amplitude instance] disableLocationListening]` at any point. If you want location tracking disabled on startup of the app, call disableLocationListening before you call `initializeApiKey:`. You can always reenable location tracking through Amplitude with `[[Amplitude instance] enableLocationListening]`.
If the user has granted your app location permissions, the SDK will also grab the location of the user. Amplitude will never prompt the user for location permissions itself, this must be done by your app.

Amplitude only polls for a location once on startup of the app, once on each app open, and once when the permission is first granted. There is no continuous tracking of location, although you can force Amplitude to grab the latest location by calling `[[Amplitude instance] updateLocation]`. Note this does consume more resources on the user's device, so use this wisely.

If you wish to disable location tracking done by the app, you can call `[[Amplitude instance] disableLocationListening]` at any point. If you want location tracking disabled on startup of the app, call disableLocationListening before you call `initializeApiKey:`. You can always reenable location tracking through Amplitude with `[[Amplitude instance] enableLocationListening]`.

### Custom Device IDs ###
Device IDs are randomly generated. You can, however, choose to instead use the identifierForVendor (if available) by calling `[[Amplitude instance] useAdvertisingIdForDeviceId]` before initializing with your API key. You can also retrieve the Device ID that Amplitude uses with `[[Amplitude instance] getDeviceId]`.
Expand Down

0 comments on commit 8e81f63

Please sign in to comment.