Android 实战:美食项目(一)
说明:前面提到了一款美食App的开发,但是那个工程由于前期设计与准备简单,所以现在从头开始对这款软件进项完整的设计开发。
软件功能简介
点击软件进入首页,在app首页中,首页中有食谱选项菜单,可以根据食谱的种类查询食谱,每个美食单元都有美食的喜爱程度以及做该美食需要的时间。点击某个美食图标进入食物详情页面,详情页面中有美食的详细信息,如食物的简介、做法、营养价值、需要的食材。在详情页面中点击右上角的收藏按钮可以对该美食进行收藏,然后点击下方进入Favorite页面可以查看自己收藏的美食食谱。
下面是demo的实现效果
demo效果
制作该demo大概需要用到的知识点
1、fragment的使用以及navigation设计的相关应用
2、recyclerVIew的使用
3、Retrofit
4、单例设计模式
5、MVVM设计模式
6、viewPager2的使用
7、Glide的了解与使用
8、高阶函数回调数据
9、密封类
10、数据可序列化
整个项目框架
图片来源:https://developer.android.google.cn/training/dependency-injection/manual?hl=zh_cn
本项目需要的所有依赖
plugins {
id 'com.android.application'
id 'kotlin-android'
id 'androidx.navigation.safeargs.kotlin'
id 'kotlin-kapt'
id 'kotlin-parcelize'
}
//Navigation
def nav_version = "2.3.5"
implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
//Gson
implementation 'com.google.code.gson:gson:2.8.7'
//retrofit
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
//Coroutine
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.0'
//ViewModel
implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.4.0-alpha02")
implementation "androidx.activity:activity-ktx:1.2.0"
implementation "androidx.fragment:fragment-ktx:1.3.0"
//by viewModels
implementation "androidx.activity:activity-ktx:1.2.0"
implementation "androidx.fragment:fragment-ktx:1.3.0"
//shimmerRecyclerView
implementation'com.facebook.shimmer:shimmer:0.5.0'
implementation'com.todkars:shimmer-recyclerview:0.4.1'
//Glide
implementation 'com.github.bumptech.glide:glide:4.12.0'
annotationProcessor 'com.github.bumptech.glide:compiler:4.12.0'
//room
def room_version = "2.3.0"
implementation("androidx.room:room-runtime:$room_version")
annotationProcessor "androidx.room:room-compiler:$room_version"
implementation("androidx.room:room-ktx:$room_version")
kapt("androidx.room:room-compiler:$room_version")
def lifecycle_version = "2.4.0-alpha02"
implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")
implementation("androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version")
implementation("androidx.lifecycle:lifecycle-runtime-ktx:$lifecycle_version")
//Jsoup
implementation 'org.jsoup:jsoup:1.13.1'
数据的搭建
配置网络权限
网络权限配置进入API平台获取数据
完成spoonacular的注册
根据需求在网址栏拼接内容
https://api.spoonacular.com/recipes/complexSearch?type=main%20course&cuisines=Chinese&addRecipeInformation=true&fillIngredients=true&apiKey=cee86c0392064ef8b4a26f4bd5e4404c
apiKey为申请的spoonacular账号的apiKey
使用Retrofit创建数据模型
1、进入上方的网址获取(复制)所有数据
2、创建数据模型(关于该插件的下载可进入Settings->Plugins进行下载安装)
创建Kotlin data class File from JSON类
将复制的数据拷贝到其中并按如下配置
配置当然别忘了Class Name
3、将需要的信息保留,删除掉不用的信息
image.png
ExrendedIngredient类
@Parcelize
data class ExtendedIngredient(
@SerializedName("aisle")
val aisle: String,
@SerializedName("amount")
val amount: Double,
@SerializedName("consistency")
val consistency: String,
@SerializedName("id")
val id: Int,
@SerializedName("image")
val image: String,
@SerializedName("name")
val name: String,
@SerializedName("original")
val original: String,
@SerializedName("unit")
val unit: String
):Parcelable
FoodRecipe类
data class FoodRecipe(
@SerializedName("results")
val results: List<Result>
)
Result类
@Parcelize
data class Result(
@SerializedName("aggregateLikes")
val aggregateLikes: Int,
@SerializedName("cheap")
val cheap: Boolean,
@SerializedName("dairyFree")
val dairyFree: Boolean,
@SerializedName("extendedIngredients")
val extendedIngredients: List<ExtendedIngredient>,
@SerializedName("glutenFree")
val glutenFree: Boolean,
@SerializedName("healthScore")
val healthScore: Double,
@SerializedName("id")
val id: Int,
@SerializedName("image")
val image: String,
@SerializedName("pricePerServing")
val pricePerServing: Double,
@SerializedName("readyInMinutes")
val readyInMinutes: Int,
@SerializedName("servings")
val servings: Int,
@SerializedName("sourceUrl")
val sourceUrl: String,
@SerializedName("spoonacularScore")
val spoonacularScore: Double,
@SerializedName("spoonacularSourceUrl")
val spoonacularSourceUrl: String,
@SerializedName("summary")
val summary: String,
@SerializedName("title")
val title: String,
@SerializedName("vegan")
val vegan: Boolean,
@SerializedName("veryHealthy")
val veryHealthy: Boolean,
@SerializedName("veryPopular")
val veryPopular: Boolean
):Parcelable
创建获取数据的接口
这里返回值中使用Response封装的原因:判断数据是否获取成功
将type设置到函数构造函数参数中,后面将实现所搜功能
package com.example.foodresp.data.remote
import com.example.foodresp.data.model.FoodRecipe
import retrofit2.Response
import retrofit2.http.GET
import retrofit2.http.Query
/**
*@Description
*@Author PC
*@QQ 1578684787
*/
interface FoodApi {
//使用Response包装,判断响应是否成功
//基地址:https://api.spoonacular.com/
@GET("recipes/complexSearch?&addRecipeInformation=true&fillIngredients=true&apiKey=cee86c0392064ef8b4a26f4bd5e4404c")
suspend fun fetchFoodRecipes(@Query("type")type:String):Response<FoodRecipe>
}
创建远程(网络)“数据仓库”
搭建Retrofit
并且给外部提供访问接口
baseUrl中的基地址和@Get中的地址以及type形成完整的访问地址
class RemoteRepository {
//创建foodApi对象
private val foodApi:FoodApi by lazy {
val retrofit = Retrofit.Builder()
.baseUrl("https://api.spoonacular.com/")
.addConverterFactory(GsonConverterFactory.create())
.build()
retrofit.create(FoodApi::class.java)
}
//给外部提供访问接口
suspend fun fetchFoodRecipes(type:String): Response<FoodRecipe>{
return foodApi.fetchFoodRecipes(type)
}
}
创建VIewModel
MainViewModel类
class MainViewModel(application: Application):AndroidViewModel(application) {
//网络请求对象
private val remoteRepository = RemoteRepository()
//提供给外部观察数据变化
var recipes: MutableLiveData<NetworkResult<FoodRecipe>> = MutableLiveData()
//外部通过这个方法发起网路请求
fun fetchFoodRecipes(type: String) {
val response = remoteResponsitory.fetchFoodRecipe(type)
}
}