android base

Android基礎

介紹

該項目的目的是：

• 一個移動客戶端應用程序示例，討論本機Android設置和開發。
• 從中啟動項目的基本模板。

規範摘要：

• 應用程序板（用戶，設置，信息...）
• 註釋應用程序示例。
• MVP清潔體系結構。
• 依賴性反轉（匕首2和黃油刀）。
• 反應性編程（RXJAVA和RXANDROID）。
• 帶有版本，語言和身份驗證（改造）的寧靜客戶端。
• 完整的單元測試覆蓋範圍（意式濃縮咖啡，Mockito和Dagger 2）。
• 其他模式和良好的做法。
• 連續集成系統。
• 腳本重置項目。

這是該應用程序消耗數據 - > rails-api-base的對應服務器API

快速開始

• 安裝您喜歡的IDE或僅安裝Android SDK（BuildTools 23.0.2和CompilesDK 23，或在dependencies.gradle中定義您自己的版本）。我使用Android Studio。

• 克隆存儲庫並進入其中：

 git clone git://github.com/jordifierro/android-base.git --origin android-base YourProjectName
cd YourProjectName

• 刪除所有“註釋”相關代碼（可選）：

 ./bin/remove_notes

• 重命名項目和軟件包名稱：

 ./bin/rename_project YourProjectName your.package.name

• 連接設備（或啟動模擬器）並運行測試：

 ./gradlew clean build cAT

• 構建成功後，創建一個新的遠程存儲庫，然後執行此重置存儲庫並將其推開：

 ./bin/reset_git https://github.com/yourusername/YourProjectName.git

就是這樣，您現在可以開始開發自己的應用程序！

注意：要運行該應用程序（您可以立即僅運行測試）記住設置API服務器（Rails-API-Base已經開發為服務此應用程序，但您也可以自行製作）並配置RestApi以連接到它（只需修改Restapi.java params）即可。

文件

應用程序本身幾乎是空的，它僅旨在提供一些基本的模塊，以某些模式實現結構並提供示例代碼。以下是規格：

應用程序板

此應用程序的主要目標是避免編寫應用程序基本樣板代碼，因此已經實現了以下功能：

• 用戶登錄
• 用戶註冊
• 用戶密碼恢復
• 具有註銷，刪除帳戶和信息鏈接的設置屏幕
• 條款和條件屏幕
• 隱私政策屏幕
• 會話持久性
• 導航
• 安息的客戶
• 應用架構骨架
• 多個測試示例

從現在開始可以使用，它還提供了添加更多代碼的結構化方法。

注意示例代碼

為了提供更多的示例代碼，它已經開發了用於管理notes代碼（例如由title和content組成的手寫筆記表示）。因此，該應用具有註釋索引，詳細信息，創建和編輯屏幕。

它的獨特目的是成為示例代碼，因此在運行./bin/remove_notes腳本時將刪除它。

MVP清潔體系結構

該代碼是按照乾淨的體系結構方法和模型視圖 - 總計（MVP）模式結構的。查看此信息以及此項目，以獲取有關它的更多信息。

依賴性反轉原理

依賴性反轉原理基本上是在應用程序上使用，以使測試變得更加容易，並使組件分解和重複使用。它還減少了樣板代碼，並有助於實例範圍的管理。用於實現這一點的圖書館是匕首2。黃油小刀用於觀看注入。

反應性編程

乾淨的體系結構使您創建不同的層，為了避免回調地獄，使用Reactivex庫應用了反應性編程範式。

帶有版本，語言和身份驗證的寧靜客戶端

作為客戶端應用程序，其主要目標是讓用戶與服務器API的數據進行交互。該項目顯示瞭如何輕鬆處理這一點。改造庫用於實現API調用方法。請求包括身份驗證，API版本和國際化。

完整的單元測試覆蓋範圍

該項目中最有趣的事情之一是它具有完整的單元測試覆蓋範圍，從數據模塊到包括所有中間層在內的Android視圖。這是使用清潔體系結構，依賴性反轉和良好測試實踐的結果。其中一個示例是視圖測試，其中視圖主持人是由overito模擬的，並通過自定義Junit Runner提供的測試匕首組件注入。

在這裡，您可以找到解釋其中一些測試的教程：

• 查看單元測試
• HTTPINTECTERS測試

模式和良好實踐

項目中使用了另一種模式和良好的實踐，例如實施活動和片段具有繼承，使用片段並在活動中定義導航，以使屏幕毫無痛苦地重塑，使用接口來解除組件... Android特定的良好實踐，例如弦樂國際化，樣式表和其他小方法。這裡是二手資源之一 - > Android最佳實踐。

連續集成系統

Travis-CI已被添加為連續集成系統，以在每個推動（Java和Android測試）上運行所有測試。

要在本地運行測試，只需連接設備或運行模擬器並執行：

 ./gradlew clean build cAT

這將同時運行Java和Android測試。

重置項目的腳本

有一些腳本/bin文件夾，可以使使用此模板從從頭開始啟動一個新項目。只需按照上面放置的“快速啟動”部分即可。

所有Shell腳本均通過ShellCheck工具驗證。

待辦事項清單

• 添加樣品集成測試。

這是該應用程序消耗數據 - > rails-api-base的對應服務器API。

貢獻

所有建議和貢獻都非常歡迎！

• 叉這個存儲庫。
• 創建您的功能分支（git Checkout -B功能名稱）。
• 開發您的功能並測試它。
• 成功運行測試：

 ./gradlew clean build cAT

• 提交您的更改（git commit -m'實現新功能'）。
• 推動更改（git推出來源功能名稱）。
• 創建一個拉請請求，我將其與項目合併。

貢獻者

不幸的是，還沒有貢獻者。

---

http://jordifierro.com