API-uri și Android: un tutorial hands-on pentru construirea unui re …

În lumea dezvoltării de aplicații de astăzi, capacitatea de a conecta și de a interacționa cu diverse servicii și baze de date este crucială. API -urile (interfețele de programare a aplicațiilor) activează această interacțiune, permițând aplicațiilor mobile să consume și să trimită date către serviciile web. În acest tutorial, vom explora cum să construim o aplicație Android simplă care consumă o API odihnitoare. Vom folosi Kotlin, retrofit și alte cele mai bune practici de programare Android.

Premise

Înainte de a ne scufunda în tutorial, asigurați -vă că aveți:

• Cunoașterea de bază a dezvoltării Android.
• Android Studio instalat.
• Familiaritatea cu limbajul de programare Kotlin.
• O API cu care să lucrezi; Pentru acest tutorial, vom folosi API -ul JSONPLICARIER, un API Fake Online Fake gratuit pentru testare și prototipare.

Pasul 1: Configurarea proiectului Android

1. Creați un nou proiect Android

   Deschideți Android Studio și creați un nou proiect. Selecta "Activitate goală," Numiți -vă proiectul "Apiexample," Și asigurați -vă că alegeți Kotlin ca limbaj de programare.

2. Configurați dependențele de gradle

   Deschide -ți build.gradle (Modul) fișier și adăugați dependențele pentru retrofit și GSON. Puteți adăuga, de asemenea, dependențe pentru suportul Coroutine, care permite apeluri asincrone.

   implementation 'com.squareup.retrofit2:retrofit:2.9.0'
   
   implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
   
   implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.5.2'
   
   implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2'

   Sincronizați -vă proiectul după adăugarea dependențelor.

Pasul 2: Crearea modelului de date

Acum, vom crea un model de date care să se potrivească cu structura JSON returnată de API -ul pe care îl vom folosi.

1. Creați o clasă de date

   Creați un nou fișier kotlin în model pachet numit Post.kt. Definiți -vă clasa de date după cum urmează:

   data class Post(
   
      val userId: Int,
   
      val id: Int,
   
      val title: String,
   
      val body: String
   
   )

Pasul 3: Configurarea retrofitului

În continuare, configurați retrofit pentru a efectua apeluri API.

1. Creați o interfață API

   Creați o nouă interfață Kotlin numită ApiService.kt:

   import retrofit2.Call
   
   import retrofit2.http.GET
   
   
   
   interface ApiService {
   
      @GET("posts")
   
      fun getPosts(): Call<List<Post>>
   
   }

2. Configurați instanța de retrofit

   Creați un alt fișier Kotlin numit RetrofitInstance.kt:

   import retrofit2.Retrofit
   
   import retrofit2.converter.gson.GsonConverterFactory
   
   
   
   object RetrofitInstance {
   
      private const val BASE_URL = "https://jsonplaceholder.typicode.com/"
   
   
   
      val api: ApiService by lazy {
   
          val retrofit = Retrofit.Builder()
   
              .baseUrl(BASE_URL)
   
              .addConverterFactory(GsonConverterFactory.create())
   
              .build()
   
   
   
          retrofit.create(ApiService::class.java)
   
      }
   
   }

Pasul 4: Implementarea apelului API în activitate

Acum vom efectua apelul API din activitatea principală pentru a prelua și afișa datele.

1. Modificați MainActivity.kt

   Actualizați -vă MainActivity pentru a include apelul API:

   import android.os.Bundle
   
   import android.util.Log
   
   import androidx.appcompat.app.AppCompatActivity
   
   import androidx.recyclerview.widget.LinearLayoutManager
   
   import androidx.recyclerview.widget.RecyclerView
   
   import retrofit2.Call
   
   import retrofit2.Callback
   
   import retrofit2.Response
   
   
   
   class MainActivity : AppCompatActivity() {
   
   
   
      private lateinit var recyclerView: RecyclerView
   
      private lateinit var postAdapter: PostAdapter // Assume you will create this adapter
   
   
   
      override fun onCreate(savedInstanceState: Bundle?) {
   
          super.onCreate(savedInstanceState)
   
          setContentView(R.layout.activity_main)
   
   
   
          recyclerView = findViewById(R.id.recycler_view)
   
          recyclerView.layoutManager = LinearLayoutManager(this)
   
   
   
          fetchPosts()
   
      }
   
   
   
      private fun fetchPosts() {
   
          RetrofitInstance.api.getPosts().enqueue(object : Callback<List<Post>> {
   
              override fun onResponse(call: Call<List<Post>>, response: Response<List<Post>>) {
   
                  if (response.isSuccessful && response.body() != null) {
   
                      postAdapter = PostAdapter(response.body()!!)
   
                      recyclerView.adapter = postAdapter
   
                  }
   
              }
   
   
   
              override fun onFailure(call: Call<List<Post>>, t: Throwable) {
   
                  Log.e("MainActivity", "Failed to fetch posts", t)
   
              }
   
          })
   
      }
   
   }

2. Creați adaptor RecyclerView

   Acum, vom avea nevoie de un adaptor pentru a popula RecyclerView. Creați un PostAdapter.kt fişier:

   import android.view.LayoutInflater
   
   import android.view.View
   
   import android.view.ViewGroup
   
   import android.widget.TextView
   
   import androidx.recyclerview.widget.RecyclerView
   
   
   
   class PostAdapter(private val postList: List<Post>) : RecyclerView.Adapter<PostAdapter.PostViewHolder>() {
   
   
   
      class PostViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
   
          val title: TextView = itemView.findViewById(R.id.post_title)
   
          val body: TextView = itemView.findViewById(R.id.post_body)
   
      }
   
   
   
      override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): PostViewHolder {
   
          val itemView = LayoutInflater.from(parent.context).inflate(R.layout.post_item, parent, false)
   
          return PostViewHolder(itemView)
   
      }
   
   
   
      override fun onBindViewHolder(holder: PostViewHolder, position: Int) {
   
          val currentItem = postList(position)
   
          holder.title.text = currentItem.title
   
          holder.body.text = currentItem.body
   
      }
   
   
   
      override fun getItemCount() = postList.size
   
   }

3. Creați fișiere de layout XML

   Creați un fișier de aspect activity_main.xml pentru activitatea principală care conține un RecyclerView:

   <androidx.recyclerview.widget.RecyclerView
   
      android:id="@+id/recycler_view"
   
      android:layout_width="match_parent"
   
      android:layout_height="match_parent"/>

   Apoi creați un fișier de aspect post_item.xml Pentru fiecare postare:

   <LinearLayout
   
      xmlns:android="http://schemas.android.com/apk/res/android"
   
      android:layout_width="match_parent"
   
      android:layout_height="wrap_content"
   
      android:padding="16dp"
   
      android:orientation="vertical">
   
   
   
      <TextView
   
          android:id="@+id/post_title"
   
          android:layout_width="wrap_content"
   
          android:layout_height="wrap_content"
   
          android:textSize="18sp"
   
          android:textStyle="bold"/>
   
   
   
      <TextView
   
          android:id="@+id/post_body"
   
          android:layout_width="wrap_content"
   
          android:layout_height="wrap_content"
   
          android:textSize="14sp"/>
   
   </LinearLayout>

Pasul 5: Rularea aplicației

Compilați și rulați aplicația. Ar trebui să vedeți o listă de titluri și corpuri poștale preluate de la API -ul JSONPLICARILOR afișat pe ecran. Puteți parcurge lista și dacă faceți clic pe orice postare, puteți extinde funcționalitatea pentru a afișa mai multe detalii sau pentru a naviga la o nouă activitate.

Concluzie

În acest tutorial, am acoperit elementele de bază ale construirii unei aplicații Android odihnitoare folosind retrofit pentru a consuma o API. Ați învățat cum să vă configurați proiectul, să creați modele de date, să faceți solicitări de rețea și să afișați rezultatele într -un reciclaj. Cu această fundație, puteți explora interacțiuni mai complexe, gestionarea erorilor și integrarea cu alte servicii. API -urile deschid o lume de posibilități pentru aplicațiile dvs., ceea ce le face instrumente puternice pentru dezvoltarea mobilă modernă. Codificare fericită!