簡介一款面向安卓初學者的個人消費記賬應用源碼包圍繞日常收支記錄、賬單分類、按時間段查詢消費情況及單筆備注說明等核心功能展開適合正在練習安卓界面布局與數(shù)據(jù)存儲的開發(fā)者參考也可作為課程設計或個人練手的完整項目范本。資源共30個文件壓縮包僅67KB包含10個png界面截圖或圖標、8個xml布局與資源配置、8個java業(yè)務邏輯源碼以及project、classpath等工程配置整體采用src、res、gen等標準安卓工程目錄組織便于直接導入開發(fā)環(huán)境閱讀和定位功能模塊。目前已有247人學習下載這份源碼可以幫助理解賬單數(shù)據(jù)如何錄入、分類、查詢與備注以及各功能模塊之間的調用關系如果對默認界面效果不太滿意也能在此基礎上自行美化UI甚至擴展圖表統(tǒng)計、多賬戶管理等進階能力。1. 先看門道這個記帳APP源碼包下載之前先想清楚三件事記帳類APP是個人開發(fā)最常練手的方向但市面上絕大多數(shù)成品APP你裝上之后堅持不過一周就刪了。原因不是功能少而是記一筆賬要點的次數(shù)太多、統(tǒng)計口徑又不貼合自己習慣。這個源碼包的價值不在“能記帳”而在它暴露了一套完整的本地數(shù)據(jù)流從界面錄入、數(shù)據(jù)落庫、按月匯總到圖表展示所有代碼都在你手里想要“今天午飯花了多少錢”這種統(tǒng)計改兩行SQL就能實現(xiàn)。適合誰想學Android數(shù)據(jù)層開發(fā)的人、想給自己定制一個離線記帳工具的人、以及剛接手別人工程需要快速看懂結構的人。直接說結論這個方向值得做但源碼不是拿來就跑的你要先弄懂三件事——表怎么設計、日期怎么處理、統(tǒng)計怎么聚合。下面我按實際改造成本最大的順序拆開講。2. 拆開源碼包先把架構和數(shù)據(jù)模型看明白再動手2.1 源碼目錄怎么擺的先分清界面層、邏輯層和數(shù)據(jù)層解壓rar之后第一眼看到的是一套標準的Android工程結構。常見做法是app目錄下按功能分包而不是按層分包。比如你可能會看到activity、fragment、adapter、db、model這幾個包。這種分包方式對新手友好但有個隱患業(yè)務邏輯容易散落在Activity里后面改統(tǒng)計規(guī)則會很痛苦?？丛创a的順序我推薦從model包開始再看db包最后看activity。因為數(shù)據(jù)模型決定了整個APP能做什么界面只是數(shù)據(jù)的投影。// 一個典型的記帳數(shù)據(jù)模型字段直接對應數(shù)據(jù)庫表列 public class RecordModel { private long id; // 主鍵自增 private long timeMillis; // 記賬時間戳單位毫秒 private int type; // 0支出1收入 private double amount; // 金額保留兩位小數(shù) private int categoryId; // 關聯(lián)分類表 private String note; // 備注可空 // getter / setter 省略 }這里有三個字段值得注意timeMillis用long存時間戳而不是存字符串這是記帳APP最基本的一條規(guī)范——所有統(tǒng)計都要按時間范圍過濾數(shù)字比較遠比字符串比較快而且不受日期格式影響type用int區(qū)分收支而不是用字符串“支出/收入”是為了SQL里SUM(CASE WHEN type 0 ...)這種寫法方便amount用double看似省事但如果你要做精確的余額計算后面我會講到更好的方案。2.2 賬本的核心是表結構category表的字段設計與類別樹記帳APP最容易被低估的是分類表。很多源碼把分類寫死在代碼里比如一個字符串數(shù)組{餐飲, 交通, 購物}。這樣做前期開發(fā)快但用戶想加一個“寵物”分類就得改代碼重新發(fā)版屬于典型的給自己挖坑。規(guī)范的做法是建一張分類表讓用戶能在設置頁增刪改。常見表結構如下CREATE TABLE category ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, -- 分類名稱如 餐飲 type INTEGER NOT NULL DEFAULT 0, -- 0支出分類1收入分類 icon TEXT, -- 圖標資源名或Unicode字符 sort_order INTEGER DEFAULT 0, -- 排序權重越小越靠前 is_default INTEGER DEFAULT 0 -- 是否系統(tǒng)預置分類 );這里type字段特別關鍵收入分類和支出分類必須分開否則統(tǒng)計頁畫餅圖時收入分類混在支出數(shù)據(jù)里會直接算錯比例。icon字段建議直接存Unicode字符或圖片資源名而不要存圖片路徑。原因是記帳APP圖標數(shù)量少、體積小存資源名在換主題時可以自動切換存路徑會導致文件還在、引用丟了的情況。如果你接手源碼時發(fā)現(xiàn)分類是寫死的我建議第一件事就是把它改成表驅動。別小看這個改動它決定了后面預算功能、報表篩選能不能做起來。改完分類表之后所有用到分類名的地方都要通過categoryId去查而不是在代碼里硬編碼。2.3 一種更省事的寫法記錄表上直接冗余category_name表結構設計里有爭議的一點記帳記錄表到底要不要冗余分類名字段。第三范式說不要但實際做統(tǒng)計報表時每次都要JOIN分類表查名字查詢語句復雜而且一旦分類改名歷史賬單的顯示會跟著變——這有時候反而是好事有時候是壞事。我見過一個改動成本極低的做法在record表里加一列category_name在寫入記錄時冗余保存當時的分類名。這樣統(tǒng)計頁直接從記錄表取值不JOIN速度更快。分類改名只影響之后的新記錄歷史賬單保持原樣對個人記帳場景來說反而更像“當時的真實記錄”。CREATE TABLE record ( id INTEGER PRIMARY KEY AUTOINCREMENT, time_millis INTEGER NOT NULL, type INTEGER NOT NULL, amount REAL NOT NULL, category_id INTEGER, category_name TEXT, note TEXT, create_time TEXT DEFAULT (datetime(now, localtime)) );當然冗余字段的代價是更新分類名時要決定策略是連歷史記錄一起改還是只改之后的。這個源碼如果沒做分類管理功能你加這個字段也不會影響現(xiàn)有邏輯。注意create_time用了SQLite默認值生成它是字符串格式只作展示用千萬不要用它來做統(tǒng)計——排序和區(qū)間過濾必須用time_millis。2.4 Gradle依賴里藏著技術棧先看懂用了哪些庫再決定改哪里任何一個Android工程app/build.gradle的 dependencies 塊就是技術棧清單。打開這個源碼的構建文件基本能看到三類依賴AndroidX基礎庫、UI控件庫、圖表庫。這三類的選型決定了代碼的寫法邊界。dependencies { implementation androidx.appcompat:appcompat:1.6.1 implementation com.google.android.material:material:1.9.0 implementation androidx.recyclerview:recyclerview:1.3.0 implementation com.github.PhilJay:MPAndroidChart:v3.1.0 implementation androidx.sqlite:sqlite:2.3.0 }看依賴清單其實是在看作者的取舍用了RecyclerView說明列表是虛擬化長列表沒用什么三方網(wǎng)絡庫說明這個APP純離線圖表庫用的是MPAndroidChart這是Android上最成熟的圖表方案餅圖和柱狀圖直接能用。如果你看到implementation而不是api說明作者在控制依賴傳遞這是好習慣。如果沒有依賴鎖定版本升級某個庫之后可能遇到API變動建議動手前先確認能否編譯過。3. 把工程跑起來從解壓到真機安裝的完整步驟3.1 環(huán)境對不上先別慌SDK版本與Gradle插件版本怎么對齊拿到源碼第一件事不是看代碼是先確認能不能編譯。這一步會攔下大半新手。Android工程的build.gradle有兩個關鍵版本號Gradle插件版本和SDK編譯版本。插件版本太老新版Android Studio打不開SDK版本太高本機沒裝對應Platform又會下載失敗。我一般會先打開根目錄的build.gradle看Gradle插件版本號。常見寫法如下plugins { id com.android.application version 7.4.0 apply false }這里7.4.0對應Gradle 7.5左右Android Studio的版本不能太舊。如果你的Studio版本是較新的大概率能直接打開。真正容易出問題的是compileSdk指向的數(shù)字比你本機SDK Platform版本高。遇到這種情況有兩種處理把compileSdk降到本機已有的版本或者讓Android Studio自動下載缺失的SDK。3.2 導入Android Studio之后第一件事改三個必改的配置項導入成功的標志是Gradle Sync跑完沒有紅色報錯。但Sync通過不等于能跑還有三個配置項我建議立刻改掉要不然第一次運行就會翻車。android { namespace com.example.account_book compileSdk 34 defaultConfig { applicationId com.example.account_book minSdk 21 targetSdk 34 } buildFeatures { viewBinding true } }第一個是applicationId這個名字是安裝包的唯一標識建議改成你自己的包名不然以后想上架或裝兩個版本會沖突第二個是minSdk這個源碼如果寫的都是新APIminSdk 21以下的老設備跑不起來不用為了兼容而降級第三個是ViewBinding這個源碼如果用的是findViewById開啟ViewBinding后重構空間很大。改完這三個配置再Sync一次基本就能裝到手機上。3.3 首次運行常見的四個失敗信號與處理順序真正點Run之后會出現(xiàn)幾種典型失敗按出現(xiàn)概率排個序。第一是編譯報錯錯誤信息定位到具體Java文件多半是SDK版本引起的API差異處理方法是按報錯提示替換API第二是安裝失敗常見原因是手機USB調試沒開或驅動問題切到Wifi調試能避開第三是打開APP閃退這時要看Logcat里的AndroidRuntime報錯九成是數(shù)據(jù)庫初始化問題——表沒建、字段對不上、空指針第四是白屏但沒閃退這通常是主題里Activity沒注冊或布局加載異常。處理順序我總結為先看Gradle版本再看SDK版本然后看minSdk和targetSdk差了多少——這個差距過大時系統(tǒng)會觸發(fā)一些兼容模式行為比如文件路徑訪問限制導致數(shù)據(jù)庫打不開。記帳APP如果打不開數(shù)據(jù)庫所有功能都白搭。4. 把核心記賬鏈路改成自己的從加一筆到看統(tǒng)計報表4.1 寫一筆賬單插入記錄與更新余額的事務處理記帳APP最核心的操作就是記一筆用戶選擇分類、輸入金額、保存?？雌饋砗唵蔚绻愕腁PP還有“總余額”或“本月結余”這種概念插入記錄時必須同時更新匯總數(shù)據(jù)這里就涉及事務。SQLite的事務并不復雜但很多人會忘記結果就是記一筆成功、余額沒變或者余額變了、記錄沒插上。正確的寫法是用SQLite的beginTransaction包住兩個操作public void insertRecord(RecordModel record) { SQLiteDatabase db dbHelper.getWritableDatabase(); db.beginTransaction(); try { ContentValues values new ContentValues(); values.put(time_millis, record.getTimeMillis()); values.put(type, record.getType()); values.put(amount, record.getAmount()); values.put(category_id, record.getCategoryId()); values.put(note, record.getNote()); db.insert(record, null, values); // 可選更新月度匯總表或余額表 db.execSQL(UPDATE summary SET total total ? WHERE month ?, new Object[]{record.getType() 0 ? -record.getAmount() : record.getAmount(), monthStr}); db.setTransactionSuccessful(); } catch (Exception e) { e.printStackTrace(); } finally { db.endTransaction(); } }這里有兩個關鍵點setTransactionSuccessful()必須在endTransaction()之前調用否則事務會回滾monthStr建議直接用yyyy-MM這種字符串從time_millis格式化出來不要自己拼年月。注意金額符號要看你們的設計如果type0是支出往匯總表里寫的時候要轉成負數(shù)這個符號約定要跟統(tǒng)計SQL一致否則圖表數(shù)據(jù)會差一倍。4.2 按月份切數(shù)據(jù)日期區(qū)間的查詢寫法與時分秒邊界記帳APP統(tǒng)計頁最常見的操作就是“查看某個月的支出”。看似簡單的WHERE time_millis BETWEEN ? AND ?翻車率極高。原因在于邊界時間你選了5月那5月1日0點0分0秒要包含5月31日23點59分59秒也要包含差一毫秒都不行。我見過很多源碼直接寫B(tài)ETWEEN 月初時間戳 AND 月末時間戳但月末時間戳取的是6月1日0點這樣會把6月1日0點0分0秒的記錄也算進去幾乎不可見但確實存在。Calendar calendar Calendar.getInstance(); calendar.set(Calendar.YEAR, year); calendar.set(Calendar.MONTH, month - 1); calendar.set(Calendar.DAY_OF_MONTH, 1); calendar.set(Calendar.HOUR_OF_DAY, 0); calendar.set(Calendar.MINUTE, 0); calendar.set(Calendar.SECOND, 0); calendar.set(Calendar.MILLISECOND, 0); long startTime calendar.getTimeInMillis(); calendar.add(Calendar.MONTH, 1); calendar.add(Calendar.MILLISECOND, -1); long endTime calendar.getTimeInMillis();這段代碼的意圖是先定位到當月1日0點然后add(Calendar.MONTH, 1)跳到下個月1日0點再回退1毫秒得到的endTime就是本月最后一天的23點59分59秒999毫秒。用這個區(qū)間查詢才不會有邊界漏數(shù)據(jù)。別小看這個細節(jié)記賬APP里所有按月統(tǒng)計的Bug百分之八十都出在這里。4.3 統(tǒng)計頁的餅圖和柱狀圖MPAndroidChart的數(shù)據(jù)裝配圖表庫選型幾乎決定了統(tǒng)計頁的寫代碼體驗。MPAndroidChart的用法是先建數(shù)據(jù)集合再裝配成DataSet最后set進Chart。餅圖的每一塊對應一個分類的金額占比柱狀圖的每一根柱子對應一天或一個月的支出總額。PieChart pieChart findViewById(R.id.pie_chart); ArrayListPieEntry entries new ArrayList(); for (CategoryStat stat : categoryStats) { entries.add(new PieEntry((float) stat.totalAmount, stat.categoryName)); } PieDataSet dataSet new PieDataSet(entries, 分類支出); dataSet.setColors(getCategoryColors(categoryStats.size())); PieData data new PieData(dataSet); pieChart.setData(data); pieChart.invalidate();這段代碼背后有個坑PieEntry的第二個參數(shù)是label它要顯示在圖例里如果分類名是中文要注意字體和長度顯示不全的問題——通常設置pieChart.setUsePercentValues(true)會讓顯示變成百分比占用空間小一些。如果統(tǒng)計結果為空要先判空否則圖表空白區(qū)域特別大如果某個分類金額為0MPAndroidChart雖然不會崩但會在圖例里保留一個0項建議裝配時過濾掉。柱狀圖同理注意BarEntry的x值是按0、1、2排的不是日期數(shù)值你要維護一個 xIndex 到日期的映射點擊柱子時才知道是哪一天。這個映射丟了柱狀圖就只能看形狀點不準。4.4 預算預警的邏輯不該寫在Adapter里單獨抽一個BudgetChecker很多人拿到源碼想加的第一個功能就是預算。常見做法是在Adapter里對比當月支出和預算額度超了就變紅。這個做法在小規(guī)模數(shù)據(jù)沒問題但一旦你加了“月初重置”“按分類預算”“超出比例閾值”這些規(guī)則Adapter會膨脹到?jīng)]法看而且每次數(shù)據(jù)刷新都要重算。我建議把預算判斷抽成一個獨立的類輸入當月支出總額和預算配置輸出一個狀態(tài)對象public class BudgetChecker { public enum BudgetStatus { NORMAL, WARNING, EXCEEDED } public static BudgetCheckResult check(double monthTotal, double budget, double warningRatio) { BudgetCheckResult result new BudgetCheckResult(); double ratio budget 0 ? monthTotal / budget : 0; if (ratio 1.0) { result.status BudgetStatus.EXCEEDED; } else if (ratio warningRatio) { result.status BudgetStatus.WARNING; } else { result.status BudgetStatus.NORMAL; } result.ratio ratio; return result; } }這里把預警閾值warningRatio當參數(shù)傳進來的意義是不同分類可以有不同的預警比例餐飲類可能用到80%就警告交通類90%才警告。返回值里同時帶status和ratioUI層拿到狀態(tài)決定顏色拿到比例決定進度條寬度。預算邏輯單獨成類之后UnitTest可以直接測不需要啟動模擬器。這個源碼如果原本沒有預算功能加這個類也不影響其他代碼改動面很小。5. 記帳APP的常見坑與排查順序從數(shù)據(jù)庫升級到鍵盤遮擋5.1 數(shù)據(jù)庫升級把老用戶數(shù)據(jù)搞沒了onUpgrade漏寫導致的翻車現(xiàn)象APP版本更新后用戶打開應用發(fā)現(xiàn)歷史賬單全沒了或者直接閃退。原因SQLiteOpenHelper的onUpgrade沒有實現(xiàn)或寫成了db.execSQL(DROP TABLE record)。這是最常見的翻車點。解決不要用DROP再重建要按版本號遷移。比如你的數(shù)據(jù)庫從版本1升到版本2字段只加了一個budget列正確的寫法是Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { if (oldVersion 2) { db.execSQL(ALTER TABLE record ADD COLUMN budget REAL DEFAULT 0); } if (oldVersion 3) { db.execSQL(ALTER TABLE record ADD COLUMN icon TEXT DEFAULT ); } }每個版本只執(zhí)行自己需要的增量語句而不是所有版本都執(zhí)行一遍。這樣即使用戶從版本1直接升到版本3也會按順序執(zhí)行到全部語句。記住任何DROP TABLE都要謹慎你的APP沒有云同步的話數(shù)據(jù)掉了就是永久掉了。5.2 日期統(tǒng)計差了8小時時區(qū)與SimpleDateFormat的坑現(xiàn)象用戶在晚上23點記了一筆賬統(tǒng)計頁里這筆賬歸到了第二天。或者“今天支出”一直是0。原因源碼里用了SimpleDateFormat(yyyy-MM-dd)轉換時間戳但沒指定時區(qū)系統(tǒng)默認時區(qū)是UTC的話本地時間21點就變成了UTC的13點日期不會變但如果你在東八區(qū)23點會變成第二天15點嗎不會UTC轉本地會差8小時跨日問題只出現(xiàn)在0點到8點之間。解決存時間戳用毫秒顯示日期時強制指定時區(qū)。SimpleDateFormat sdf new SimpleDateFormat(yyyy-MM-dd, Locale.CHINA); sdf.setTimeZone(TimeZone.getDefault()); String dateStr sdf.format(new Date(timeMillis));更穩(wěn)的方案是在統(tǒng)計SQL里直接用datetime(time_millis/1000, unixepoch, localtime)來格式化SQLite自帶的localdate處理已經(jīng)考慮了時區(qū)偏移。注意這里time_millis/1000是單位轉換如果表里存的是納秒就會差一千倍先確認字段單位再寫SQL。5.3 軟鍵盤把輸入框頂飛windowSoftInputMode沒配好現(xiàn)象在記帳頁面輸入金額時彈出的鍵盤把輸入框和按鈕頂出屏幕用戶看不到“保存”按鈕。原因AndroidManifest里Activity沒有配置windowSoftInputMode默認行為是系統(tǒng)自行調整窗口大小布局沒有滑動能力就被擠壓變形。解決在記帳Activity上設置合適的軟鍵盤模式。activity android:name.activity.EditRecordActivity android:windowSoftInputModeadjustResize /同時保證根布局是ScrollView或使用android:windowSoftInputModeadjustPan。哪個效果好實測下來adjustResize配合ScrollView最穩(wěn)妥鍵盤彈出時布局壓縮、ScrollView能滾到輸入框位置adjustPan是整體上移布局復雜時會擋到其他元素。還有一種情況是底部有RecyclerView的頁面鍵盤彈出會導致列表重新layout這時候要檢查android:windowSoftInputModeadjustNothing的替代方案或者收起鍵盤代替調整窗口。5.4 圖標在低版本上顯示成方框vector兼容與vectorDrawables.useSupportLibrary現(xiàn)象某個分類的圖標在Android 7以上的手機顯示正常在Android 6上顯示成方框或者干脆不顯示。原因項目只用了vector圖標但沒開兼容模式。Android 5.0以下原生不支持vector drawable需要在編譯配置里開開關讓support庫處理。解決android { defaultConfig { vectorDrawables.useSupportLibrary true } }除了開開關還要檢查引用方式。如果是在布局里直接android:srcdrawable/ic_food要在ImageView上加上app:srcCompat這個屬性而不是android:src。這是個老生常談的細節(jié)但很多源碼里混用了兩種寫法導致同一個圖標有的頁面能用、有的頁面顯示方框。記帳APP分類圖標一般都有幾十個如果不想逐個排查把圖標統(tǒng)一換成Unicode emoji字符也能避開這個問題。5.5 查詢卡UI主線程查大表與游標沒關的問題現(xiàn)象打開統(tǒng)計頁時界面卡頓一兩秒或者在不斷記帳幾個月之后APP啟動變慢。原因統(tǒng)計SQL在主線程執(zhí)行數(shù)據(jù)量大了以后全表掃描耗時明顯。解決統(tǒng)計類查詢移到子線程用回調更新UI。new Thread(() - { Cursor cursor db.rawQuery(SELECT ..., null); ListCategoryStat list new ArrayList(); while (cursor.moveToNext()) { // 解析到 list } cursor.close(); runOnUiThread(() - renderPieChart(list)); }).start();注意上面的cursor.close()位置在循環(huán)外、回調前順序不能反否則游標沒釋放、第二次查詢內存泄漏。如果每次記帳都很卡檢查有沒有在主線程做數(shù)據(jù)庫寫入除了beginTransaction把多次寫包到一起減少IO次數(shù)之外還可以用setWriteAheadLoggingEnabled(true)打開WAL模式讀寫并行不阻塞。6. 進階做法把這套源碼改造成能長期使用的工具6.1 給數(shù)據(jù)上后悔藥CSV導出與自動備份記帳數(shù)據(jù)丟了是最痛苦的這一小節(jié)講給源碼加一個“后悔藥”功能。簡單可靠的方案是加一個“導出CSV”按鈕把record表全部導出到Downloads目錄下這樣即使APP被卸載數(shù)據(jù)還在。File file new File(Environment.getExternalStoragePublicDirectory( Environment.DIRECTORY_DOWNLOADS), account_backup.csv); FileOutputStream fos new FileOutputStream(file); OutputStreamWriter osw new OutputStreamWriter(fos, StandardCharsets.UTF_8); osw.write(時間,類型,分類,金額,備注\n); SimpleDateFormat sdf new SimpleDateFormat(yyyy-MM-dd HH:mm:ss, Locale.CHINA); while (cursor.moveToNext()) { osw.write(sdf.format(new Date(cursor.getLong(0))) ,); osw.write(cursor.getString(2) ,); osw.write(cursor.getInt(1) 0 ? 支出, : 收入,); osw.write(cursor.getDouble(3) ,); osw.write(cursor.getString(4) \n); } osw.close();這段代碼覆蓋了三個關鍵點導出時加了UTF-8 BOM頭否則Excel打開中文會亂碼日期格式化成可讀字符串方便人看而不是機器看類型轉成了中文。如果想要更強的“后悔藥”建議每周自動向應用私有目錄歸檔一份數(shù)據(jù)庫文件歸檔用文件復制而不是導出CSV因為恢復時直接替換數(shù)據(jù)庫文件比解析CSV快得多、也不會丟字段。6.2 后續(xù)改造的優(yōu)先順序從Room遷移到遠程同步前的最后一站如果你打算長期維護這個APP我建議改造順序是先把分類表驅動改完再加CSV導出然后考慮把SQLiteOpenHelper換成Room。不要一上來就上Room因為源碼現(xiàn)有的SQL語句和查詢邏輯已經(jīng)能跑強行遷移會引入大量ORM概念反而增加出錯面。等現(xiàn)有功能穩(wěn)定了再按Room的Entity、Dao、Database三層重新組織遷移時保留數(shù)據(jù)庫版本號和遷移腳本用戶數(shù)據(jù)不會丟。最后講一個我自己的教訓記帳源碼改到最后總是會忍不住加“美觀的動畫”和“復雜的手勢操作”結果是把核心的記帳路徑搞復雜了自己都不想打開。我現(xiàn)在的習慣是每加一個功能前先問一句“這個功能會讓我多記一筆賬嗎”——答案是否。把這句話分享給你希望幫到你。本文還有配套的精品資源點擊獲取