嘿，作为SwiftUI新手遇到这个问题很正常，我来给你一个简单可行的解决方案，刚好适配Xcode11的环境！

核心思路其实很简单：用状态变量控制弹窗的显示/隐藏，再结合UserDefaults记录用户是否已经看过指引，首次启动时自动触发弹窗。

方案一：使用系统Alert弹窗 #

这是最快捷的实现方式，用SwiftUI原生的Alert组件，配合onAppear方法在视图加载时判断是否显示：

import SwiftUI

struct ContentView: View {
    // 控制弹窗显示的状态变量
    @State private var showingGuide = false
    
    var body: some View {
        // 这里是你的游戏主界面，示例用文本代替
        Text("Bullseye 游戏主界面")
            .font(.largeTitle)
            .onAppear {
                // 检查UserDefaults中是否有已看过指引的标记
                let hasSeenGuide = UserDefaults.standard.bool(forKey: "hasSeenGuide")
                if !hasSeenGuide {
                    // 首次启动，触发弹窗
                    self.showingGuide = true
                    // 标记为已看过，避免下次启动重复显示
                    UserDefaults.standard.set(true, forKey: "hasSeenGuide")
                }
            }
            // 绑定弹窗状态，自动显示/隐藏
            .alert(isPresented: $showingGuide) {
                Alert(
                    title: Text("Bullseye 操作指引"),
                    message: Text("1. 拖动滑块调整目标数值\n2. 点击射击按钮计算得分\n3. 越接近目标数值得分越高"),
                    dismissButton: .default(Text("明白了"))
                )
            }
    }
}

方案二：自定义弹窗视图 #

如果你想要更个性化的弹窗样式（比如自定义布局、颜色），可以用叠加层实现自定义弹窗：

import SwiftUI

struct ContentView: View {
    @State private var showingGuide = false
    
    var body: some View {
        ZStack {
            // 游戏主界面
            Text("Bullseye 游戏主界面")
                .font(.largeTitle)
            
            // 自定义弹窗：只有showingGuide为true时显示
            if showingGuide {
                GuideOverlay(showingGuide: $showingGuide)
                    .background(Color.black.opacity(0.5))
                    .edgesIgnoringSafeArea(.all)
            }
        }
        .onAppear {
            let hasSeenGuide = UserDefaults.standard.bool(forKey: "hasSeenGuide")
            if !hasSeenGuide {
                self.showingGuide = true
                UserDefaults.standard.set(true, forKey: "hasSeenGuide")
            }
        }
    }
}

// 自定义指引弹窗视图
struct GuideOverlay: View {
    @Binding var showingGuide: Bool
    
    var body: some View {
        VStack(spacing: 24) {
            Text("欢迎来到 Bullseye！")
                .font(.title)
                .bold()
            
            VStack(alignment: .leading, spacing: 12) {
                Text("🎯 拖动滑块设置你想要的数值")
                Text("🎮 点击「射击」按钮计算得分")
                Text("🏆 数值越接近目标，得分越高")
            }
            .font(.body)
            
            Button("开始游戏") {
                showingGuide = false
            }
            .padding(.horizontal, 32)
            .padding(.vertical, 12)
            .background(Color.orange)
            .foregroundColor(.white)
            .cornerRadius(8)
        }
        .padding()
        .background(Color.white)
        .cornerRadius(16)
        .padding()
    }
}

测试小技巧 #

如果你想反复测试弹窗效果，可以：

• 删除模拟器中的APP后重新运行
• 或者在Xcode调试控制台执行命令重置标记：

  UserDefaults.standard.set(false, forKey: "hasSeenGuide")
  

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