使用 Kotlin 從 0 到 1 Android 串接 Firebase 推播 — 基礎篇

Sean Lin
verybuy-dev
Published in
6 min readAug 14, 2017

大家好,這篇文章會分享如何一步步的在 Android APP 上串接 Firebase 的推播功能,並且使用 Android 上的新一代官方語言 Kotlin 做介紹。

我預計會分兩個篇幅來分享,第一篇主要介紹環境的建立與最基本的推播功能,第二篇會介紹進階的使用,包括很多人搞不清楚的推播前後景的問題

一、建立一個Android專案

這裡使用的ide工具是 Android Studio 3.0,因為筆者在寫這篇文章時的版本還停在 Beta2 上,不是正式釋出的穩定版本,不過以下的文章內容在 Android Studio 2.x 都是可以正常執行沒有問題的,所以請大家斟卓使用。

開啟 Android Studio 程式後,點選 Start a new Android Studio project 建立一個新專案

接下來在第一個欄位 Application name 的欄位輸入想要使用的專案名稱

第二個欄位 Company domain 輸人公司或個人的網域位置,不知道的話可以使用預設的就可以了

第三欄 Project location 是專案的存放位置,選擇自已想放置的位置即可

最後下面有一個 include Kotlin support 因 kotlin 本文主要使用的語言,所以維持預設的打勾選取即可

如果你使用的ide是3.0以前的版本,可以直接下載kotlin的插件引入使用 kotlin 就可以了

二、建立 Firebase 專案

建立好 app 後,我們要在 Firebase 上面建立一個專案

開啟 Firebase 的控制台頁面,點選大大藍色的 新增專案 按鈕建立專案。

在專案名稱打上自已想要的專案名子,這邊的例子是 FirebaseNotificationExample

在國家的地方選擇台灣,最後按下藍色的 建立專案 按鈕就完成專案的建立了。

三、建立 Firebase 專案下的應用程式

專案建立好了已後,我們會進到這個專案的頁面,因為是全新的專案,所以看到上面是空的,沒有任何應用程式。

Firebase可以建立 Android、IOS、Web 三種不同類型的應用程式,對應不同的平台。

我們這篇講的是 Android,所以選擇 將 Firebase 加入您的 Android 應用程式 就可以了

建立應用程式有三個步驟,第一步先填入前面建立 App 的 Package,這裡的例子是 tw.com.nanasutdio.firebasenotification

應用程式暱稱和偵錯簽署憑證可以之後再加入,所以這裡先跳過,直接點選 註冊應用程式 進入下一步

註冊好應用程式後,Firebase 會產生一組設定檔讓我們下載使用,只要照者畫面上的指示下載 google-service.json 這個設定檔放入自已的專案目錄下及即可

最後我們要在 Gradle 中加入前一步加入的設定檔引用設定,一樣照者畫面上的指示分別在 專案層級 應用程式層級 加入一行程式碼,然後按 完成 就完成應用程式的建立了

四、App 與 Firebase 連結

接下來我們把焦點從網頁移回我們的開發工具 Android Studio

新版的 Android Studio 上有引入了方便的精靈工具,只要在上面的表單上選 Tolls -> Firebase 照者上面的指示,就可以很快的直接把推播的功能加入我們的 App中。

不過可以自動加入當然也可以手動加入,下面就來介紹手動加入的方法

compile ‘com.google.firebase:firebase-core:11.0.4’

compile ‘com.google.firebase:firebase-messaging:11.0.4’

我們要先在 應用程式層級dependencies 內加人這兩行 Firebase 核心和推播sdk的引用

接下來編譯並執行 App,確定 App 執行起來後,按返回鍵退出 App,我們就可以開始第一次的測試了

我們回到 Firebase 的控制台,選擇 Notifications 來送出我們的第一個測試通知

我們依序輸入想傳送的訊息內容,然後選擇應用程式,最後按下送出訊息

沒有問題的話我們會在手機上收到我們送出的第一則推播通知。我們的基礎篇也到此結束了。

下一篇會來講比較進階的部份,包括上面為什麼要先退出 App 再傳送測試通知的原因

--

--