Android Studio 導入 Android-PullToRefresh 庫：正確姿勢是 Existing Android Code

現象

下載 Android-PullToRefresh-master 後，File → New → Import Module 選中目錄，Projects 列表為空，無法導入。

原因

該庫是 Eclipse ADT 結構（含 project.properties、AndroidManifest.xml 在根目錄），非 Gradle 模塊。AS 默認的 Import Module (Gradle) 無法識別。

解決步驟

1. File → New → Import Module（或 File → Import）。
2. 在彈出窗口選擇 Eclipse ADT / Gradle 區域下的 Existing Android Code Into Workspace（部分版本顯示為 Import Eclipse ADT Projects）。
3. 瀏覽選中庫根目錄，Finish。AS 會自動生成 build.gradle 並遷移為 Gradle 結構。
4. 導入後，在 settings.gradle 中會出現 include ':pulltorefresh'，主模塊 build.gradle 添加 implementation project(':pulltorefresh')。

現代替代方案

該庫最後更新於 2015 年，建議直接使用：

• SmartRefreshLayout：implementation 'com.scwang.smart:refresh-layout-kernel:2.0.5'，Kotlin 友好、Header/Footer 豐富、NestedScrolling 完美支持。
• AndroidX SwipeRefreshLayout：implementation 'androidx.swiperefreshlayout:swiperefreshlayout:1.1.0'，官方維護，輕量。

避坑提醒

1. 若庫含 .so 需手動複製到 jniLibs。
2. 導入後 Clean Project → Rebuild，消除 R 文件衝突。