Android Studio 中使用 SQLite 数据库开发完整指南（Kotlin版本） ...

  

1. 项目准备

1.1 创建新项目

• 打开 Android Studio
  
• 选择 “Start a new Android Studio project”
  
• 选择 “Empty Activity” 模板
  
• 设置项目名称（比方 “SQLiteDemo”）
  
• 选择语言（Kotlin 或 Java，本教程以 Kotlin 为例）
  
• 设置最低 API 级别（建议 API 21 或更高）
  
• 点击 “Finish” 完成项目创建
  

1.2 添加必要依赖

确保 build.gradle (Module: app) 中包含以下依赖：

1. dependencies {
2.     implementation 'androidx.core:core-ktx:1.7.0'
3.     implementation 'androidx.appcompat:appcompat:1.4.1'
4.     implementation 'com.google.android.material:material:1.5.0'
5.     implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
6.    
7.     // Room 数据库（SQLite 的抽象层）
8.     implementation "androidx.room:room-runtime:2.4.2"
9.     implementation "androidx.room:room-ktx:2.4.2"
10.     kapt "androidx.room:room-compiler:2.4.2"
11.    
12.     // 协程支持
13.     implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.0'
14.    
15.     // ViewModel 和 LiveData
16.     implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.4.1"
17.     implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.4.1"
18.    
19.     testImplementation 'junit:junit:4.13.2'
20.     androidTestImplementation 'androidx.test.ext:junit:1.1.3'
21.     androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
22. }

复制代码

点击 “Sync Now” 同步项目。
2. 数据库设计

假设我们要创建一个简单的条记应用，包含以下数据表：

• notes 表：
  
  
  
  • id: 主键，自增
    
  • title: 条记标题
    
  • content: 条记内容
    
  • created_at: 创建时间
    
  • updated_at: 更新时间
    
  
  

3. 实现数据库

3.1 创建实体类 (Entity)

在 com.yourpackage.model 包下创建 Note.kt 文件：

1. import androidx.room.Entity
2. import androidx.room.PrimaryKey
3. import java.util.*
5. @Entity(tableName = "notes")
6. data class Note(
7.     @PrimaryKey(autoGenerate = true)
8.     val id: Long = 0,
9.    
10.     var title: String,
11.     var content: String,
12.    
13.     val created_at: Date = Date(),
14.     var updated_at: Date = Date()
15. )

复制代码

3.2 创建数据访问对象 (DAO)

在 com.yourpackage.dao 包下创建 NoteDao.kt 文件：

1. import androidx.lifecycle.LiveData
2. import androidx.room.*
3. import com.yourpackage.model.Note
5. @Dao
6. interface NoteDao {
7.    
8.     @Insert(onConflict = OnConflictStrategy.REPLACE)
9.     suspend fun insertNote(note: Note): Long
10.    
11.     @Update
12.     suspend fun updateNote(note: Note)
13.    
14.     @Delete
15.     suspend fun deleteNote(note: Note)
16.    
17.     @Query("SELECT * FROM notes ORDER BY updated_at DESC")
18.     fun getAllNotes(): LiveData<List<Note>>
19.    
20.     @Query("SELECT * FROM notes WHERE id = :noteId")
21.     suspend fun getNoteById(noteId: Long): Note?
22.    
23.     @Query("SELECT * FROM notes WHERE title LIKE :query OR content LIKE :query ORDER BY updated_at DESC")
24.     fun searchNotes(query: String): LiveData<List<Note>>
25. }

复制代码

3.3 创建数据库类

在 com.yourpackage.database 包下创建 AppDatabase.kt 文件：

1. import android.content.Context
2. import androidx.room.Database
3. import androidx.room.Room
4. import androidx.room.RoomDatabase
5. import com.yourpackage.dao.NoteDao
6. import com.yourpackage.model.Note
8. @Database(entities = [Note::class], version = 1, exportSchema = false)
9. abstract class AppDatabase : RoomDatabase() {
10.    
11.     abstract fun noteDao(): NoteDao
12.    
13.     companion object {
14.         @Volatile
15.         private var INSTANCE: AppDatabase? = null
16.         
17.         fun getDatabase(context: Context): AppDatabase {
18.             return INSTANCE ?: synchronized(this) {
19.                 val instance = Room.databaseBuilder(
20.                     context.applicationContext,
21.                     AppDatabase::class.java,
22.                     "notes_database"
23.                 )
24.                     .fallbackToDestructiveMigration() // 数据库升级策略，简单应用可以这样设置
25.                     .build()
26.                 INSTANCE = instance
27.                 instance
28.             }
29.         }
30.     }
31. }

复制代码

4. 创建 Repository

在 com.yourpackage.repository 包下创建 NoteRepository.kt 文件：

1. import androidx.lifecycle.LiveData
2. import com.yourpackage.dao.NoteDao
3. import com.yourpackage.model.Note
4. import kotlinx.coroutines.Dispatchers
5. import kotlinx.coroutines.withContext
7. class NoteRepository(private val noteDao: NoteDao) {
8.    
9.     val allNotes: LiveData<List<Note>> = noteDao.getAllNotes()
10.    
11.     suspend fun insert(note: Note): Long {
12.         return withContext(Dispatchers.IO) {
13.             noteDao.insertNote(note)
14.         }
15.     }
16.    
17.     suspend fun update(note: Note) {
18.         withContext(Dispatchers.IO) {
19.             note.updated_at = Date()
20.             noteDao.updateNote(note)
21.         }
22.     }
23.    
24.     suspend fun delete(note: Note) {
25.         withContext(Dispatchers.IO) {
26.             noteDao.deleteNote(note)
27.         }
28.     }
29.    
30.     suspend fun getNoteById(id: Long): Note? {
31.         return withContext(Dispatchers.IO) {
32.             noteDao.getNoteById(id)
33.         }
34.     }
35.    
36.     fun searchNotes(query: String): LiveData<List<Note>> {
37.         return noteDao.searchNotes("%$query%")
38.     }
39. }

复制代码

5. 创建 ViewModel

在 com.yourpackage.viewmodel 包下创建 NoteViewModel.kt 文件：

1. import androidx.lifecycle.ViewModel
2. import androidx.lifecycle.ViewModelProvider
3. import androidx.lifecycle.asLiveData
4. import androidx.lifecycle.viewModelScope
5. import com.yourpackage.model.Note
6. import com.yourpackage.repository.NoteRepository
7. import kotlinx.coroutines.launch
9. class NoteViewModel(private val repository: NoteRepository) : ViewModel() {
10.    
11.     val allNotes = repository.allNotes
12.    
13.     fun insert(note: Note) = viewModelScope.launch {
14.         repository.insert(note)
15.     }
16.    
17.     fun update(note: Note) = viewModelScope.launch {
18.         repository.update(note)
19.     }
20.    
21.     fun delete(note: Note) = viewModelScope.launch {
22.         repository.delete(note)
23.     }
24.    
25.     fun getNoteById(id: Long) = viewModelScope.launch {
26.         repository.getNoteById(id)
27.     }
28.    
29.     fun searchNotes(query: String) = repository.searchNotes(query).asLiveData()
30. }
32. class NoteViewModelFactory(private val repository: NoteRepository) : ViewModelProvider.Factory {
33.     override fun <T : ViewModel> create(modelClass: Class<T>): T {
34.         if (modelClass.isAssignableFrom(NoteViewModel::class.java)) {
35.             @Suppress("UNCHECKED_CAST")
36.             return NoteViewModel(repository) as T
37.         }
38.         throw IllegalArgumentException("Unknown ViewModel class")
39.     }
40. }

复制代码

6. 实现 UI 层

6.1 创建条记列表 Activity

创建 NotesListActivity.kt 和对应的结构文件 activity_notes_list.xml
activity_notes_list.xml

1. <?xml version="1.0" encoding="utf-8"?>
2. <androidx.coordinatorlayout.widget.CoordinatorLayout
3.     xmlns:android="http://schemas.android.com/apk/res/android"
4.     xmlns:app="http://schemas.android.com/apk/res-auto"
5.     xmlns:tools="http://schemas.android.com/tools"
6.     android:layout_width="match_parent"
7.     android:layout_height="match_parent"
8.     tools:context=".ui.NotesListActivity">
10.     <com.google.android.material.appbar.AppBarLayout
11.         android:layout_width="match_parent"
12.         android:layout_height="wrap_content"
13.         android:theme="@style/Theme.SQLiteDemo.AppBarOverlay">
15.         <androidx.appcompat.widget.Toolbar
16.             android:id="@+id/toolbar"
17.             android:layout_width="match_parent"
18.             android:layout_height="?attr/actionBarSize"
19.             android:background="?attr/colorPrimary"
20.             app:popupTheme="@style/Theme.SQLiteDemo.PopupOverlay"
21.             app:title="@string/app_name" />
23.         <com.google.android.material.textfield.TextInputLayout
24.             android:id="@+id/search_layout"
25.             android:layout_width="match_parent"
26.             android:layout_height="wrap_content"
27.             style="@style/Widget.MaterialComponents.TextInputLayout.OutlinedBox">
29.             <com.google.android.material.textfield.TextInputEditText
30.                 android:id="@+id/search_input"
31.                 android:layout_width="match_parent"
32.                 android:layout_height="wrap_content"
33.                 android:hint="@string/search_hint"
34.                 android:imeOptions="actionSearch"
35.                 android:inputType="text" />
36.         </com.google.android.material.textfield.TextInputLayout>
37.     </com.google.android.material.appbar.AppBarLayout>
39.     <androidx.recyclerview.widget.RecyclerView
40.         android:id="@+id/notes_recycler_view"
41.         android:layout_width="match_parent"
42.         android:layout_height="match_parent"
43.         android:clipToPadding="false"
44.         android:paddingBottom="72dp"
45.         app:layout_behavior="@string/appbar_scrolling_view_behavior" />
47.     <com.google.android.material.floatingactionbutton.FloatingActionButton
48.         android:id="@+id/fab_add_note"
49.         android:layout_width="wrap_content"
50.         android:layout_height="wrap_content"
51.         android:layout_gravity="bottom|end"
52.         android:layout_margin="16dp"
53.         android:contentDescription="@string/add_note"
54.         android:src="@drawable/ic_add"
55.         app:backgroundTint="@color/purple_500"
56.         app:tint="@android:color/white" />
58. </androidx.coordinatorlayout.widget.CoordinatorLayout>

复制代码

NotesListActivity.kt

1. import android.content.Intent
2. import android.os.Bundle
3. import android.view.Menu
4. import android.view.MenuItem
5. import android.view.inputmethod.EditorInfo
6. import androidx.activity.viewModels
7. import androidx.appcompat.app.AppCompatActivity
8. import androidx.recyclerview.widget.LinearLayoutManager
9. import com.google.android.material.snackbar.Snackbar
10. import com.yourpackage.R
11. import com.yourpackage.adapter.NotesAdapter
12. import com.yourpackage.databinding.ActivityNotesListBinding
13. import com.yourpackage.model.Note
14. import com.yourpackage.viewmodel.NoteViewModel
15. import com.yourpackage.viewmodel.NoteViewModelFactory
17. class NotesListActivity : AppCompatActivity() {
18.    
19.     private lateinit var binding: ActivityNotesListBinding
20.     private lateinit var notesAdapter: NotesAdapter
21.    
22.     private val viewModel: NoteViewModel by viewModels {
23.         NoteViewModelFactory((application as NotesApplication).repository)
24.     }
25.    
26.     override fun onCreate(savedInstanceState: Bundle?) {
27.         super.onCreate(savedInstanceState)
28.         binding = ActivityNotesListBinding.inflate(layoutInflater)
29.         setContentView(binding.root)
30.         
31.         setSupportActionBar(binding.toolbar)
32.         
33.         setupRecyclerView()
34.         setupSearch()
35.         setupFAB()
36.         observeNotes()
37.     }
38.    
39.     private fun setupRecyclerView() {
40.         notesAdapter = NotesAdapter { note ->
41.             // 点击笔记项时的操作
42.             val intent = Intent(this, NoteDetailActivity::class.java).apply {
43.                 putExtra(NoteDetailActivity.EXTRA_NOTE_ID, note.id)
44.             }
45.             startActivity(intent)
46.         }
47.         
48.         binding.notesRecyclerView.apply {
49.             layoutManager = LinearLayoutManager(this@NotesListActivity)
50.             adapter = notesAdapter
51.             setHasFixedSize(true)
52.         }
53.     }
54.    
55.     private fun setupSearch() {
56.         binding.searchInput.setOnEditorActionListener { _, actionId, _ ->
57.             if (actionId == EditorInfo.IME_ACTION_SEARCH) {
58.                 val query = binding.searchInput.text.toString().trim()
59.                 if (query.isNotEmpty()) {
60.                     viewModel.searchNotes(query).observe(this) { notes ->
61.                         notesAdapter.submitList(notes)
62.                     }
63.                 } else {
64.                     observeNotes() // 如果查询为空，返回所有笔记
65.                 }
66.                 true
67.             } else {
68.                 false
69.             }
70.         }
71.     }
72.    
73.     private fun setupFAB() {
74.         binding.fabAddNote.setOnClickListener {
75.             val intent = Intent(this, NoteDetailActivity::class.java)
76.             startActivity(intent)
77.         }
78.     }
79.    
80.     private fun observeNotes() {
81.         viewModel.allNotes.observe(this) { notes ->
82.             notesAdapter.submitList(notes)
83.         }
84.     }
85.    
86.     override fun onCreateOptionsMenu(menu: Menu): Boolean {
87.         menuInflater.inflate(R.menu.menu_main, menu)
88.         return true
89.     }
90.    
91.     override fun onOptionsItemSelected(item: MenuItem): Boolean {
92.         return when (item.itemId) {
93.             R.id.action_delete_all -> {
94.                 deleteAllNotes()
95.                 true
96.             }
97.             else -> super.onOptionsItemSelected(item)
98.         }
99.     }
100.    
101.     private fun deleteAllNotes() {
102.         viewModel.allNotes.value?.let { notes ->
103.             if (notes.isNotEmpty()) {
104.                 for (note in notes) {
105.                     viewModel.delete(note)
106.                 }
107.                 Snackbar.make(binding.root, "All notes deleted", Snackbar.LENGTH_SHORT).show()
108.             }
109.         }
110.     }
111. }

复制代码

6.2 创建条记详情 Activity

创建 NoteDetailActivity.kt 和对应的结构文件 activity_note_detail.xml
activity_note_detail.xml

1. <?xml version="1.0" encoding="utf-8"?>
2. <androidx.coordinatorlayout.widget.CoordinatorLayout
3.     xmlns:android="http://schemas.android.com/apk/res/android"
4.     xmlns:app="http://schemas.android.com/apk/res-auto"
5.     xmlns:tools="http://schemas.android.com/tools"
6.     android:layout_width="match_parent"
7.     android:layout_height="match_parent"
8.     tools:context=".ui.NoteDetailActivity">
10.     <com.google.android.material.appbar.AppBarLayout
11.         android:layout_width="match_parent"
12.         android:layout_height="wrap_content"
13.         android:theme="@style/Theme.SQLiteDemo.AppBarOverlay">
15.         <androidx.appcompat.widget.Toolbar
16.             android:id="@+id/toolbar"
17.             android:layout_width="match_parent"
18.             android:layout_height="?attr/actionBarSize"
19.             android:background="?attr/colorPrimary"
20.             app:popupTheme="@style/Theme.SQLiteDemo.PopupOverlay" />
21.     </com.google.android.material.appbar.AppBarLayout>
23.     <androidx.core.widget.NestedScrollView
24.         android:layout_width="match_parent"
25.         android:layout_height="match_parent"
26.         app:layout_behavior="@string/appbar_scrolling_view_behavior">
28.         <LinearLayout
29.             android:layout_width="match_parent"
30.             android:layout_height="wrap_content"
31.             android:orientation="vertical"
32.             android:padding="16dp">
34.             <com.google.android.material.textfield.TextInputLayout
35.                 android:id="@+id/title_layout"
36.                 android:layout_width="match_parent"
37.                 android:layout_height="wrap_content"
38.                 style="@style/Widget.MaterialComponents.TextInputLayout.OutlinedBox">
40.                 <com.google.android.material.textfield.TextInputEditText
41.                     android:id="@+id/title_input"
42.                     android:layout_width="match_parent"
43.                     android:layout_height="wrap_content"
44.                     android:hint="@string/title_hint"
45.                     android:inputType="textCapSentences|textAutoCorrect"
46.                     android:maxLines="1" />
47.             </com.google.android.material.textfield.TextInputLayout>
49.             <com.google.android.material.textfield.TextInputLayout
50.                 android:id="@+id/content_layout"
51.                 android:layout_width="match_parent"
52.                 android:layout_height="wrap_content"
53.                 android:layout_marginTop="16dp"
54.                 style="@style/Widget.MaterialComponents.TextInputLayout.OutlinedBox">
56.                 <com.google.android.material.textfield.TextInputEditText
57.                     android:id="@+id/content_input"
58.                     android:layout_width="match_parent"
59.                     android:layout_height="wrap_content"
60.                     android:hint="@string/content_hint"
61.                     android:inputType="textMultiLine|textCapSentences|textAutoCorrect"
62.                     android:minLines="5"
63.                     android:gravity="top" />
64.             </com.google.android.material.textfield.TextInputLayout>
65.         </LinearLayout>
66.     </androidx.core.widget.NestedScrollView>
68.     <com.google.android.material.floatingactionbutton.FloatingActionButton
69.         android:id="@+id/fab_save"
70.         android:layout_width="wrap_content"
71.         android:layout_height="wrap_content"
72.         android:layout_gravity="bottom|end"
73.         android:layout_margin="16dp"
74.         android:contentDescription="@string/save_note"
75.         android:src="@drawable/ic_save"
76.         app:backgroundTint="@color/purple_500"
77.         app:tint="@android:color/white" />
79. </androidx.coordinatorlayout.widget.CoordinatorLayout>

复制代码

NoteDetailActivity.kt

1. import android.os.Bundle
2. import android.text.Editable
3. import android.text.TextWatcher
4. import android.view.MenuItem
5. import androidx.activity.viewModels
6. import androidx.appcompat.app.AppCompatActivity
7. import com.google.android.material.snackbar.Snackbar
8. import com.yourpackage.R
9. import com.yourpackage.databinding.ActivityNoteDetailBinding
10. import com.yourpackage.model.Note
11. import com.yourpackage.viewmodel.NoteViewModel
12. import com.yourpackage.viewmodel.NoteViewModelFactory
13. import java.util.*
15. class NoteDetailActivity : AppCompatActivity() {
16.    
17.     companion object {
18.         const val EXTRA_NOTE_ID = "extra_note_id"
19.     }
20.    
21.     private lateinit var binding: ActivityNoteDetailBinding
22.     private val viewModel: NoteViewModel by viewModels {
23.         NoteViewModelFactory((application as NotesApplication).repository)
24.     }
25.    
26.     private var noteId: Long = -1L
27.     private var isNewNote = true
28.    
29.     override fun onCreate(savedInstanceState: Bundle?) {
30.         super.onCreate(savedInstanceState)
31.         binding = ActivityNoteDetailBinding.inflate(layoutInflater)
32.         setContentView(binding.root)
33.         
34.         setSupportActionBar(binding.toolbar)
35.         supportActionBar?.setDisplayHomeAsUpEnabled(true)
36.         
37.         noteId = intent.getLongExtra(EXTRA_NOTE_ID, -1L)
38.         isNewNote = noteId == -1L
39.         
40.         if (!isNewNote) {
41.             loadNote()
42.         }
43.         
44.         setupSaveButton()
45.         setupTextWatchers()
46.     }
47.    
48.     private fun loadNote() {
49.         viewModel.getNoteById(noteId)
50.         viewModel.allNotes.observe(this) { notes ->
51.             notes.find { it.id == noteId }?.let { note ->
52.                 binding.titleInput.setText(note.title)
53.                 binding.contentInput.setText(note.content)
54.             }
55.         }
56.     }
57.    
58.     private fun setupSaveButton() {
59.         binding.fabSave.setOnClickListener {
60.             saveNote()
61.         }
62.     }
63.    
64.     private fun setupTextWatchers() {
65.         binding.titleInput.addTextChangedListener(object : TextWatcher {
66.             override fun beforeTextChanged(s: CharSequence?, start: Int, count: Int, after: Int) {}
67.             override fun onTextChanged(s: CharSequence?, start: Int, before: Int, count: Int) {}
68.             override fun afterTextChanged(s: Editable?) {
69.                 validateInputs()
70.             }
71.         })
72.         
73.         binding.contentInput.addTextChangedListener(object : TextWatcher {
74.             override fun beforeTextChanged(s: CharSequence?, start: Int, count: Int, after: Int) {}
75.             override fun onTextChanged(s: CharSequence?, start: Int, before: Int, count: Int) {}
76.             override fun afterTextChanged(s: Editable?) {
77.                 validateInputs()
78.             }
79.         })
80.     }
81.    
82.     private fun validateInputs(): Boolean {
83.         val titleValid = binding.titleInput.text?.isNotBlank() ?: false
84.         val contentValid = binding.contentInput.text?.isNotBlank() ?: false
85.         
86.         binding.titleLayout.error = if (!titleValid) getString(R.string.title_required) else null
87.         binding.contentLayout.error = if (!contentValid) getString(R.string.content_required) else null
88.         
89.         return titleValid && contentValid
90.     }
91.    
92.     private fun saveNote() {
93.         if (!validateInputs()) return
94.         
95.         val title = binding.titleInput.text.toString()
96.         val content = binding.contentInput.text.toString()
97.         
98.         if (isNewNote) {
99.             val note = Note(title = title, content = content)
100.             viewModel.insert(note)
101.             Snackbar.make(binding.root, "Note saved", Snackbar.LENGTH_SHORT).show()
102.             finish()
103.         } else {
104.             viewModel.allNotes.value?.find { it.id == noteId }?.let { existingNote ->
105.                 val updatedNote = existingNote.copy(
106.                     title = title,
107.                     content = content,
108.                     updated_at = Date()
109.                 )
110.                 viewModel.update(updatedNote)
111.                 Snackbar.make(binding.root, "Note updated", Snackbar.LENGTH_SHORT).show()
112.                 finish()
113.             }
114.         }
115.     }
116.    
117.     override fun onOptionsItemSelected(item: MenuItem): Boolean {
118.         return when (item.itemId) {
119.             android.R.id.home -> {
120.                 onBackPressed()
121.                 true
122.             }
123.             else -> super.onOptionsItemSelected(item)
124.         }
125.     }
126. }

复制代码

6.3 创建 RecyclerView Adapter

在 com.yourpackage.adapter 包下创建 NotesAdapter.kt 文件：

1. import android.view.LayoutInflater
2. import android.view.View
3. import android.view.ViewGroup
4. import androidx.recyclerview.widget.DiffUtil
5. import androidx.recyclerview.widget.ListAdapter
6. import androidx.recyclerview.widget.RecyclerView
7. import com.yourpackage.R
8. import com.yourpackage.databinding.ItemNoteBinding
9. import com.yourpackage.model.Note
10. import java.text.SimpleDateFormat
11. import java.util.*
13. class NotesAdapter(private val onItemClick: (Note) -> Unit) :
14.     ListAdapter<Note, NotesAdapter.NoteViewHolder>(NoteDiffCallback()) {
15.    
16.     override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): NoteViewHolder {
17.         val binding = ItemNoteBinding.inflate(
18.             LayoutInflater.from(parent.context),
19.             parent,
20.             false
21.         )
22.         return NoteViewHolder(binding, onItemClick)
23.     }
24.    
25.     override fun onBindViewHolder(holder: NoteViewHolder, position: Int) {
26.         holder.bind(getItem(position))
27.     }
28.    
29.     class NoteViewHolder(
30.         private val binding: ItemNoteBinding,
31.         private val onItemClick: (Note) -> Unit
32.     ) : RecyclerView.ViewHolder(binding.root) {
33.         
34.         fun bind(note: Note) {
35.             binding.apply {
36.                 noteTitle.text = note.title
37.                 noteContent.text = note.content
38.                
39.                 val dateFormat = SimpleDateFormat("MMM dd, yyyy - hh:mm a", Locale.getDefault())
40.                 noteDate.text = dateFormat.format(note.updated_at)
41.                
42.                 root.setOnClickListener {
43.                     onItemClick(note)
44.                 }
45.             }
46.         }
47.     }
48.    
49.     private class NoteDiffCallback : DiffUtil.ItemCallback<Note>() {
50.         override fun areItemsTheSame(oldItem: Note, newItem: Note): Boolean {
51.             return oldItem.id == newItem.id
52.         }
53.         
54.         override fun areContentsTheSame(oldItem: Note, newItem: Note): Boolean {
55.             return oldItem == newItem
56.         }
57.     }
58. }

复制代码

创建对应的列表项结构文件 item_note.xml：

1. <?xml version="1.0" encoding="utf-8"?>
2. <com.google.android.material.card.MaterialCardView
3.     xmlns:android="http://schemas.android.com/apk/res/android"
4.     xmlns:app="http://schemas.android.com/apk/res-auto"
5.     android:layout_width="match_parent"
6.     android:layout_height="wrap_content"
7.     android:layout_margin="8dp"
8.     app:cardCornerRadius="8dp"
9.     app:cardElevation="4dp">
11.     <LinearLayout
12.         android:layout_width="match_parent"
13.         android:layout_height="wrap_content"
14.         android:orientation="vertical"
15.         android:padding="16dp">
17.         <TextView
18.             android:id="@+id/note_title"
19.             android:layout_width="match_parent"
20.             android:layout_height="wrap_content"
21.             android:textAppearance="@style/TextAppearance.AppCompat.Headline"
22.             android:textColor="@android:color/black" />
24.         <TextView
25.             android:id="@+id/note_content"
26.             android:layout_width="match_parent"
27.             android:layout_height="wrap_content"
28.             android:layout_marginTop="8dp"
29.             android:ellipsize="end"
30.             android:maxLines="2"
31.             android:textAppearance="@style/TextAppearance.AppCompat.Body1"
32.             android:textColor="@android:color/darker_gray" />
34.         <TextView
35.             android:id="@+id/note_date"
36.             android:layout_width="match_parent"
37.             android:layout_height="wrap_content"
38.             android:layout_marginTop="8dp"
39.             android:textAppearance="@style/TextAppearance.AppCompat.Caption"
40.             android:textColor="@android:color/darker_gray" />
41.     </LinearLayout>
42. </com.google.android.material.card.MaterialCardView>

复制代码

6.4 创建 Application 类

在 com.yourpackage 包下创建 NotesApplication.kt 文件：

1. import android.app.Application
2. import com.yourpackage.database.AppDatabase
3. import com.yourpackage.repository.NoteRepository
5. class NotesApplication : Application() {
6.    
7.     val database by lazy { AppDatabase.getDatabase(this) }
8.     val repository by lazy { NoteRepository(database.noteDao()) }
9. }

复制代码

更新 AndroidManifest.xml 文件，添加 android:name 属性：

1. <application
2.     android:name=".NotesApplication"
3.     android:allowBackup="true"
4.     android:icon="@mipmap/ic_launcher"
5.     android:label="@string/app_name"
6.     android:roundIcon="@mipmap/ic_launcher_round"
7.     android:supportsRtl="true"
8.     android:theme="@style/Theme.SQLiteDemo">
9.     <!-- 其他配置 -->
10. </application>

复制代码

7. 添加菜单资源

在 res/menu 目录下创建 menu_main.xml 文件：

1. <?xml version="1.0" encoding="utf-8"?>
2. <menu xmlns:android="http://schemas.android.com/apk/res/android"
3.     xmlns:app="http://schemas.android.com/apk/res-auto">
4.    
5.     <item
6.         android:id="@+id/action_delete_all"
7.         android:icon="@drawable/ic_delete"
8.         android:title="@string/delete_all"
9.         app:showAsAction="never" />
10. </menu>

复制代码

8. 添加字符串资源

在 res/values/strings.xml 文件中添加以下字符串：

1. <resources>
2.     <string name="app_name">SQLite Notes</string>
3.     <string name="title_hint">Title</string>
4.     <string name="content_hint">Content</string>
5.     <string name="search_hint">Search notes...</string>
6.     <string name="add_note">Add new note</string>
7.     <string name="save_note">Save note</string>
8.     <string name="delete_all">Delete all notes</string>
9.     <string name="title_required">Title is required</string>
10.     <string name="content_required">Content is required</string>
11. </resources>

复制代码

9. 添加图标资源

确保在 res/drawable 目录下有以下矢量图标：

• ic_add.xml (添加按钮图标)
  
• ic_save.xml (生存按钮图标)
  
• ic_delete.xml (删除按钮图标)
  

10. 运行和测试应用

现在，您可以运行应用程序并测试以下功能：

• 添加新条记
  
• 查看条记列表
  
• 编辑现有条记
  
• 删除条记
  
• 搜刮条记
  
• 删除所有条记
  

11. 数据库调试本事

11.1 查看数据库内容

• 在 Android Studio 中打开 “Device File Explorer” (View -> Tool Windows -> Device File Explorer)
  
• 导航到 /data/data/com.yourpackage/databases/
  
• 找到 notes_database 文件
  
• 右键点击并选择 “Save As” 将其生存到本地
  
• 使用 SQLite 浏览器工具（如 DB Browser for SQLite）打开该文件查看内容
  

11.2 使用 Stetho 进行调试

添加 Stetho 依赖到 build.gradle:

1. implementation 'com.facebook.stetho:stetho:1.6.0'

复制代码

在 NotesApplication.kt 中初始化 Stetho:

1. import com.facebook.stetho.Stetho
3. class NotesApplication : Application() {
4.     override fun onCreate() {
5.         super.onCreate()
6.         Stetho.initializeWithDefaults(this)
7.     }
8.    
9.     // 其他代码...
10. }

复制代码

运行应用后，在 Chrome 浏览器中访问 chrome://inspect 可以查看和调试数据库。
12. 数据库迁移

当您需要更改数据库结构时（比方添加新表或修改现有表），需要进行数据库迁移。
12.1 修改实体类

比方，我们要为 Note 添加一个 is_pinned 字段：

1. @Entity(tableName = "notes")
2. data class Note(
3.     // 现有字段...
4.     var is_pinned: Boolean = false
5. )

复制代码

12.2 更新数据库版本

修改 AppDatabase.kt:

1. @Database(entities = [Note::class], version = 2, exportSchema = false)
2. abstract class AppDatabase : RoomDatabase() {
3.     // ...
4. }

复制代码

12.3 添加迁移策略

1. val migration1to2 = object : Migration(1, 2) {
2.     override fun migrate(database: SupportSQLiteDatabase) {
3.         database.execSQL("ALTER TABLE notes ADD COLUMN is_pinned INTEGER NOT NULL DEFAULT 0")
4.     }
5. }
7. // 在 databaseBuilder 中添加迁移
8. val instance = Room.databaseBuilder(
9.     context.applicationContext,
10.     AppDatabase::class.java,
11.     "notes_database"
12. )
13.     .addMigrations(migration1to2)
14.     .build()

复制代码

13. 性能优化建议

• 使用事件：对于批量操作，使用事件可以显著进步性能：
  

1. @Dao
2. interface NoteDao {
3.     @Transaction
4.     suspend fun insertAll(notes: List<Note>) {
5.         notes.forEach { insertNote(it) }
6.     }
7. }

复制代码

• 索引优化：为常用查询字段添加索引：
  

1. @Entity(tableName = "notes", indices = [Index(value = ["title"], unique = false)])
2. data class Note(
3.     // ...
4. )

复制代码

• 分页加载：对于大量数据，使用 Paging 库：
  

1. @Query("SELECT * FROM notes ORDER BY updated_at DESC")
2. fun getPagedNotes(): PagingSource<Int, Note>

复制代码

• 避免在主线程操作数据库：始终确保数据库操作在后台线程执行。
  

14. 完整项目结构

终极项目结构应类似于：

1. com.yourpackage
2. ├── adapter
3. │   └── NotesAdapter.kt
4. ├── dao
5. │   └── NoteDao.kt
6. ├── database
7. │   └── AppDatabase.kt
8. ├── model
9. │   └── Note.kt
10. ├── repository
11. │   └── NoteRepository.kt
12. ├── ui
13. │   ├── NotesListActivity.kt
14. │   └── NoteDetailActivity.kt
15. ├── viewmodel
16. │   ├── NoteViewModel.kt
17. │   └── NoteViewModelFactory.kt
18. └── NotesApplication.kt

复制代码

15. 总结

本指南具体介绍了在 Android Studio 中使用 SQLite 数据库的完整开发流程，包罗：

• 设置项目和依赖
  
• 设计数据库结构
  
• 实现 Room 数据库组件（Entity, DAO, Database）
  
• 创建 Repository 层
  
• 实现 ViewModel
  
• 构建用户界面
  
• 添加数据库迁移支持
  
• 性能优化建议
  

通过遵照这些步调，您可以构建一个功能美满、结构清晰的 Android 应用，充实利用 SQLite 数据库的强大功能。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。