2018年2月20日 星期二

【Android】如何取得SHA1指紋認證與MD5

在很多地方都會需要用到 SHA 指紋認證,要取得 SHA 之前必須先擁有 keystore , keystore 又分為正式版與測試版,測試版的keystore在安裝 Android SDK 時就會一併產生在電腦中,正式版 keystore 則需要自己打包產生,以 Windows 系統為例
測試版 keystore 路徑為 C:\Users\YOUR_NAME\.android\debug.keystore

要取得 SHA 有兩種方式:
1. cmd (windows 命令提示字元) 下 command line
2. 在 Android Studio 內運行 Gradle 指令快速取得(只適用 debug keystore)




● 在 Windows 環境下使用 keytool 取得簽署憑證的 SHA 雜湊值


1.打開 命令提示字元(cmd) 視窗 / (使用Git Bash 也行)
2.切換路徑到 JDK 的 bin 資料夾 指令 : cd C:\Program Files\Java\jdk1.8.0_144\bin (黃字部分自行替換)
3.查詢指令 : keytool -list -v -keystore "C:\Users\YOUR_NAME\.android\debug.keystore" (黃字部分自行替換)
4.打上密碼 (debug.keystore 預設密碼為 android)







● 在 Android Studio 內快速取得 dubug 認證


如果手邊有 AS IDE 的話,打開專案,點開測邊欄的 Gradle 視窗,找到 Tasks 資料夾,這裡面有一些預設寫好的腳本可以執行,接著找到android -> signingReport,直接執行便可以得到電腦內 debug.keystore 的指紋認證等資訊



2017年8月17日 星期四

【Android】Kotlin data class 使用心得



『Kotlin 將會取代 Java』


這是無庸置疑的,就好比『Swift 將會取代 Objective-C』,既然身為 Android 開發者的我們終究要面對,不如趁早來使用它!在使用 Kotlin 之前,我的 model 一直都是用 auto-value 來實作,原本我已經認為 auto-value 是極致的簡潔了(之前還特地寫了一系列的文章介紹),但兩者相較之下 Kotlin 撰寫出來的程式碼又更勝一籌

●基本介紹
在 Kotlin 裡面,只要在 class 的前面加上 data 這個關鍵字,你的class就會自動升級為 data class(這不是廢話嗎!),在變成所謂的 data class之後,Kotlin 的 compiler 便會根據你的 properties 自動幫你 override 掉原先的equals()/hashCode()/toString()這三個 method(當然如果你有自己的規則也是可以自己實作),並且幫你生成相對應的 getter and setter 以及 copy()

Before:
public class User {
    private final String name;
    private int age;
    
    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        User user = (User) o;
        if (age != user.age) return false;
        return name != null ? name.equals(user.name) : user.name == null;

    }

    @Override
    public int hashCode() {
        int result = name != null ? name.hashCode() : 0;
        result = 31 * result + age;
        return result;
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }

    public String getName() {
        return name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

After:
data class User(val name: String, var age: Int)




上面的 User 有兩個 property,其中 name 為常數(不可變),在Java裡面我們將它定義為 final,而且只提供 getter 沒有 setter;
在 Kotlin 中沒有 final 這個關鍵字,必須使用 val / var 來區分常數 / 變數

val = 常數 = 僅提供 getter
var = 變數 = 提供 getter and setter

data class 也很貼心的幫我們生成了一個名為 cope() 的 method,具體用法如下:
val anson = User(name = "Anson", age = 18)
val bnson = anson.copy(name = "Bnson")
val olderBnson = bnson.copy(age= 19)




●實作 Parcelable
如果我們要在 Kotlin 中去實作 Parcelable 介面,除了硬幹之外,其實也是有不錯的 3rd party library :

● Parceler
● PaperParcel
● Smuggler

這邊我使用的是 Smuggler 這套,用起來最為簡單方便

Before:
data class User(val name: String, val age: Int) : Parcelable {
    constructor(parcel: Parcel) : this(
            parcel.readString(),
            parcel.readInt())
 
    override fun writeToParcel(parcel: Parcel, flags: Int) {
        parcel.writeString(name)
        parcel.writeInt(age)
    }
 
    override fun describeContents(): Int {
        return 0
    }
 
    companion object CREATOR : Parcelable.Creator<user> {
        override fun createFromParcel(parcel: Parcel): User {
            return User(parcel)
        }
 
        override fun newArray(size: Int): Array<user> {
            return arrayOfNulls(size)
        }
    }
}

After:
data class User (val name: String, val age: Int) : AutoParcelable 



● Extension data class?
試想一下,如果我們的 model 有繼承關係在呢? 如果有一些property是所有 model 都會去用到的,那麼已往在 Java 時我們常常會將設計成一個Base類,然後其他 model 再去繼承他,大概會變成這樣(以下省略 methods 實作):
public abstract class Base {
    public String token;

    public Base(String token) {
        this.token = token;
    }
}

public class User extends Base implements Parcelable{
    public String name;
    public int age;


    public User(String token, String name, int age) {
        super(token);
        this.name = name;
        this.age = age;
    }

    protected User(Parcel in) {
        super(in.readString());
        name = in.readString();
        age = in.readInt();
    }

    public static final Creator<user> CREATOR = new Creator<user>() {
        @Override
        public User createFromParcel(Parcel in) {
            return new User(in);
        }

        @Override
        public User[] newArray(int size) {
            return new User[size];
        }
    };

    @Override
    public int describeContents() {
        return 0;
    }

    @Override
    public void writeToParcel(Parcel dest, int flags) {
        dest.writeString(token);
        dest.writeString(name);
        dest.writeInt(age);
    }
}
但如果換到了 Kotlin,我們宣告成 data class 時便會造成一個奇怪的現象
究竟是 Base 要去實作 equals,toString...還是 User 呢 ?
其實 Kotlin 的官方部落格有探討過這個問題了 (原文)
那如果我們依舊要保留一樣的設計,去確保程式的嚴謹性時該怎麼辦呢?
這時只需要將原本的抽象類改成介面即可😃

interface Base {
    val token: String
}

data class User(override val token: String, val name: String, val age: Int) : Base, AutoParcelable

2016年12月14日 星期三

【Android】最簡潔的Model層 - AutoValue 使用介紹【三】

這篇要來說的是 AutoValue 如何搭配【Gson】一塊使用,

由於已經將 Model 內原先的field變更為 abstract method 了,

可想而知在 Gson de/serialize 的過程中會發生問題!

ps.如果不了解 Gson 可以先參考我的另一篇文章

不做任何處理的話會發現在 call Gson 的 fromJson() 時會噴出 Exception,

java.lang.RuntimeException: Failed to invoke public com.yourpackagename.Book() with no args
如果要讓 Gson 成功的序列化,就必須給它一個新的 parse 規則(預設規則不適用在我們的 AutoValue Model 身上),

這邊我們一樣會用到一個 library【auto-value-gson

接下來只需要幾個簡單步驟:
一、在 Model 類別內新增靜態的 typeAdapter() method
二、新增一個抽象類實作 TypeAdapterFactory,並添加一個可產生物件的靜態 method
三、使用 GsonBuilder 來 create Gson,並給予我們自訂義的 TypeAdapterFactory




Gradle:

//auto-value-gson
provided 'com.ryanharter.auto.value:auto-value-gson:0.4.6'
annotationProcessor 'com.ryanharter.auto.value:auto-value-gson:0.4.6'



After:

//步驟一

@AutoValue
public abstract class Book {
    public abstract String name();
    public abstract int price();
    public abstract String author();

    public static Book create(String name, int price, String author) {
        return new AutoValue_Book(name, price, author);
    }

    public static TypeAdapter<Book> typeAdapter(Gson gson) {
        return new AutoValue_Book.GsonTypeAdapter(gson);
    }
}
//步驟二

@GsonTypeAdapterFactory
public abstract class GsonAdapterFactory implements TypeAdapterFactory {
    public static TypeAdapterFactory create() {
        return new AutoValueGson_GsonAdapterFactory();
    }
}
//步驟三

String jsonString = "{\"author\":\"Anson\",\"name\":\"安森瓦舍\",\"price\":87}";
Gson gson = new GsonBuilder().registerTypeAdapterFactory(GsonAdapterFactory.create()).create();
//serialize
Book book = gson.fromJson(jsonString, Book.class);
//deserialize
System.out.println(gson.toJson(book));



這邊特別要注意的是【步驟二】的 return new AutoValueGson_GsonAdapterFactory() 的部分,
如果你在【步驟一】的 model 中沒有 typeAdapter 的靜態方法,那麼在 build project 時,AutoValueGson_GsonAdapterFactory 是不會被創建出來的。所以步驟可別亂掉!




最後,我在github上創建了一個Project來演示AotoValue與Rxjava2Retrofit2搭配使用的範例。




延伸閱讀:

● 最簡潔的Model層 - AutoValue 使用介紹【一】
● 最簡潔的Model層 - AutoValue 使用介紹【二】