From 8e81f6302ded94ce1677f4b814325790d68bc628 Mon Sep 17 00:00:00 2001 From: Daniel Jih Date: Fri, 15 Jan 2016 14:59:49 -0800 Subject: [PATCH] v3.5.0 --- Amplitude-iOS.podspec | 4 ++-- Amplitude/AMPConstants.m | 2 +- CHANGELOG.md | 2 ++ README.md | 8 ++++++-- 4 files changed, 11 insertions(+), 5 deletions(-) diff --git a/Amplitude-iOS.podspec b/Amplitude-iOS.podspec index 984c6533..52856085 100644 --- a/Amplitude-iOS.podspec +++ b/Amplitude-iOS.podspec @@ -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 diff --git a/Amplitude/AMPConstants.m b/Amplitude/AMPConstants.m index 60920654..da331f2f 100644 --- a/Amplitude/AMPConstants.m +++ b/Amplitude/AMPConstants.m @@ -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; diff --git a/CHANGELOG.md b/CHANGELOG.md index a8e899e0..80f7b688 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,7 @@ ## Unreleased +## 3.5.0 (January 15, 2016) + * Add ability to clear all user properties. ## 3.4.1 (December 31, 2015) diff --git a/README.md b/README.md index 0a8d8b5a..ffe9b18b 100644 --- a/README.md +++ b/README.md @@ -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)". @@ -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]`.