title: 快速入门

你可以通过邮箱登录的例子来了解身份认证的基本用法。

环境准备

  • 支持 Android Studio 1.4 以上或者 Eclipse ADT 15.0.0 以上版本
  • 支持 JDK 7.0 以上版本
  • 支持 Android 手机系统 4.0.3以上版本,即 Android SDK 15 以上版本

1. 创建应用

首先,你需要在控制面板中创建应用。

2. 安装 SDK

SDK 的安装方式有两种,你可以任选其一:

  • 使用 Maven
  1. <dependency>
    <groupId>com.wilddog.client</groupId>
    <artifactId>wilddog-auth-android</artifactId>
    <version>2.0.7</version>
    </dependency>
  • 使用 Gradle

在build.gradle中添加:

  1. dependencies {
    compile 'com.wilddog.client:wilddog-auth-android:2.0.7'
    }

如果出现文件重复导致的编译错误,可以选择在build.grade中添加packagingOptions:

  1. android {
  2. ...
  3. packagingOptions {
  4. exclude 'META-INF/LICENSE'
  5. exclude 'META-INF/NOTICE'
  6. }
  7. }

3. 配置 Android 权限

在 AndroidMainfest.xml 文件中添加:

  1. <uses-permission android:name="android.permission.INTERNET"/>

4. 创建 Auth 实例

使用 Wilddog Auth SDK 之前,需要先创建实例:

  1. WilddogOptions options = new WilddogOptions.Builder().setSyncUrl("https://<wilddog appId>.wilddogio.com").build();
  2. WilddogApp.initializeApp(this, options);
  3. WilddogAuth wilddogAuth = WilddogAuth.getInstance();

5. 使用邮箱认证

1.开启邮箱登录

在 控制面板—身份认证—登录方式 中开启邮箱登录功能:

title:  快速入门 - 图1

2.创建新用户

  1. wilddogAuth.createUserWithEmailAndPassword("123456789@qq.com","45678901").addOnCompleteListener(new OnCompleteListener<AuthResult>() {
  2. @Override
  3. public void onComplete(Task<AuthResult> var1) {
  4. if(var1.isSuccessful()){
  5. Log.d("result","Create user success")
  6. }
  7. else{
  8. Log.d("result","reason:"+var1.getException().toString())
  9. }
  10. }
  11. }

3.邮箱密码登录

signInWithEmailAndPassword() 方法用于已创建的用户登录:

  1. wildoogAuth.signInWithEmailAndPassword("123456789@qq.com","45678901").addOnCompleteListener(new OnCompleteListener<AuthResult>() {
  2. @Override
  3. public void onComplete(Task<AuthResult> var1) {
  4. if(var1.isSuccessful()){
  5. Log.d("success","Login success!"); // 登录成功
  6. Log.d("Anonymous",String.valueOf(var1.getResult().getWilddogUser().isAnonymous()));
  7. } else {
  8. Log.d("failure","reason:"+var1.getException().toString()); // 登录失败及错误信息
  9. }
  10. }
  11. });

6. 退出登录

signOut() 方法用于退出当前登录用户:

  1. wilddogAuth.signOut();

Auth 更多使用方式,请参考 完整指南API 文档