Kotlin实现主应用加载/切屏时顶部显示进度界面方案问询

核心思路 #

由于Service无法显示UI，且常规启动页仅在应用启动时生效，我们可以通过在当前界面的顶层添加一个悬浮加载View的方式实现需求。所有UI操作均在主线程完成（符合Kotlin单UI线程的限制），通过控制该View的显示/隐藏，实现加载时自动弹出、加载完成后自动关闭的效果。

代码实现 #

1. 定义顶部加载布局 (layout_top_loading.xml)

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/topLoadingContainer"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="#E0FFFFFF"
    android:gravity="center"
    android:orientation="horizontal"
    android:padding="8dp"
    android:visibility="gone"
    android:elevation="8dp"> <!-- 设置层级确保在其他View之上 -->

    <ProgressBar
        android:layout_width="24dp"
        android:layout_height="24dp"
        android:indeterminate="true" />

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="8dp"
        android:text="加载中..." />
</LinearLayout>

2. Activity中集成加载逻辑 (MainActivity.kt)

将上述布局嵌入到Activity的主布局最顶部，然后通过代码控制显示/隐藏：

import android.os.Bundle
import android.os.Handler
import android.os.Looper
import androidx.appcompat.app.AppCompatActivity
import androidx.fragment.app.FragmentTransaction
import kotlinx.android.synthetic.main.activity_main.*
import kotlinx.android.synthetic.main.layout_top_loading.*

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 示例：点击按钮切换Fragment时触发加载
        switchFragmentBtn.setOnClickListener {
            showTopLoading()
            // 模拟耗时加载操作（实际场景替换为接口请求、Fragment初始化等）
            Handler(Looper.getMainLooper()).postDelayed({
                // 加载完成后切换Fragment
                supportFragmentManager.beginTransaction()
                    .replace(R.id.fragmentContainer, TestFragment())
                    .commit()
                hideTopLoading()
            }, 2000)
        }
    }

    private fun showTopLoading() {
        topLoadingContainer.visibility = View.VISIBLE
    }

    private fun hideTopLoading() {
        topLoadingContainer.visibility = View.GONE
    }
}

3. Fragment内调用加载逻辑 (TestFragment.kt)

在Fragment中可以通过Activity引用控制顶部加载View：

import android.os.Bundle
import android.os.Handler
import android.os.Looper
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import androidx.fragment.app.Fragment
import kotlinx.android.synthetic.main.fragment_test.*

class TestFragment : Fragment() {
    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        return inflater.inflate(R.layout.fragment_test, container, false)
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        // 模拟Fragment内部的加载操作
        activity?.findViewById<View>(R.id.topLoadingContainer)?.visibility = View.VISIBLE
        Handler(Looper.getMainLooper()).postDelayed({
            contentTv.text = "Fragment加载完成"
            activity?.findViewById<View>(R.id.topLoadingContainer)?.visibility = View.GONE
        }, 1500)
    }
}

4. 全局封装加载管理（可选）

如果多个页面需要使用，可以封装单例类统一管理：

import android.app.Activity
import android.view.View

object LoadingManager {
    private var loadingView: View? = null

    fun init(activity: Activity) {
        loadingView = activity.findViewById(R.id.topLoadingContainer)
    }

    fun show() {
        loadingView?.visibility = View.VISIBLE
    }

    fun hide() {
        loadingView?.visibility = View.GONE
    }
}

使用时在Activity的onCreate中初始化：LoadingManager.init(this)，之后直接调用LoadingManager.show()和LoadingManager.hide()即可。

注意事项 #

• 耗时操作必须放在子线程执行（例如使用Kotlin协程Coroutine），避免阻塞主线程导致加载界面卡顿
• 确保加载View的层级高于其他UI元素（通过android:elevation或FrameLayout的层级顺序实现）
• 如果需要在多个Activity之间切换时保持加载状态，可以将加载View放在自定义的BaseActivity中，所有Activity继承该基类

内容的提问来源于stack exchange，提问作者jetberrocal