feat(user): option for clearing anonymous id

Author: zapcannon87

AVOS/LeanCloudObjcTests/LCUserTestCase.swift

@@ -14,8 +14,8 @@ class LCUserTestCase: BaseTestCase {
     static let testablePhoneNumber = "+8618622223333"
     static let testableSMSCode = "170402"
 
+    /*
     func testVerifyPhoneNumberBySMSCode() {
-        /*
         let user = LCUser()
         let username = uuid
         let password = uuid
@@ -58,11 +58,11 @@ class LCUserTestCase: BaseTestCase {
                 exp.fulfill()
             }
         }
-         */
     }
+     */
 
+    /*
     func testUpdatePhoneNumberBySMSCode() {
-        /*
         let user = LCUser()
         let username = uuid
         let password = uuid
@@ -105,7 +105,40 @@ class LCUserTestCase: BaseTestCase {
                 exp.fulfill()
             }
         }
-        */
+    }
+     */
+    
+    func testLogOut() {
+        var uid1: String?
+        expecting { exp in
+            LCUser.loginAnonymously { user, error in
+                uid1 = user?.objectId
+                XCTAssertNotNil(uid1)
+                XCTAssertNil(error)
+                exp.fulfill()
+            }
+        }
+        
+        LCUser.logOut(withClearingAnonymousId: false)
+        
+        expecting { exp in
+            LCUser.loginAnonymously { user, error in
+                XCTAssertEqual(uid1, user?.objectId)
+                XCTAssertNil(error)
+                exp.fulfill()
+            }
+        }
+        
+        LCUser.logOut()
+        
+        expecting { exp in
+            LCUser.loginAnonymously { user, error in
+                XCTAssertNotNil(user?.objectId)
+                XCTAssertNotEqual(uid1, user?.objectId)
+                XCTAssertNil(error)
+                exp.fulfill()
+            }
+        }
     }
 
     func testFriendshipRequestAccept() {

AVOS/Sources/Foundation/User/LCUser.h

@@ -322,14 +322,16 @@ FOUNDATION_EXPORT LeanCloudSocialPlatform const LeanCloudSocialPlatformWeiXin;
                                               password:(NSString *)password
                                                  block:(LCUserResultBlock)block;
 
+// MARK: Log out
 
-/** @name Logging Out */
-
-/*!
- Logs out the currently logged in user on disk.
- */
+/// Clearing local persistent cache data of the current user and set it to `nil`.
+/// It will also clearing local persistent cache of anonymous id.
 + (void)logOut;
 
+/// Clearing local persistent cache data of the current user and set it to `nil`.
+/// @param clearingAnonymousId `true` means clearing local persistent cache of anonymous id, `false` means NOT.
++ (void)logOutWithClearingAnonymousId:(BOOL)clearingAnonymousId;
+
 /** @name Requesting a Password Reset */
 
 

AVOS/Sources/Foundation/User/LCUser.m

@@ -647,11 +647,17 @@ + (void)signUpOrLoginWithMobilePhoneNumberInBackground:(NSString *)phoneNumber
     }];
 }
 
-// MARK: - logout
+// MARK: Log out
 
 + (void)logOut {
-    [[NSUserDefaults standardUserDefaults] removeObjectForKey:AnonymousIdKey];
-    [[self class] changeCurrentUser:nil save:YES];
+    [self logOutWithClearingAnonymousId:true];
+}
+
++ (void)logOutWithClearingAnonymousId:(BOOL)clearingAnonymousId {
+    if (clearingAnonymousId) {
+        [[NSUserDefaults standardUserDefaults] removeObjectForKey:AnonymousIdKey];
+    }
+    [self changeCurrentUser:nil save:true];
 }
 
 // MARK: - password reset