فهرست سرفصل‌های Swift
خانه (Swift HOME) معرفی (Swift Intro) شروع به کار (Swift Get Started) سینتکس (Swift Syntax) دستورات (Swift Statements) خروجی (Swift Output) چاپ اعداد (Print Numbers) کامنت ها (Swift Comments) متغیرها (Swift Variables) چاپ متغیرها (Print Variables) چند متغیره (Multiple Variables) شناسه ها (Identifiers) ثابت ها (Constants) نمونه های دنیای واقعی (Real-Life Examples) انواع داده (Swift Data Types) اعداد (Numbers) بولی ها (Booleans) کاراکترها (Characters) تبدیل نوع (Swift Type Casting) عملگرها (Swift Operators) عملگرهای حسابی (Arithmetic Operators) عملگرهای انتساب (Assignment Operators) عملگرهای مقایسه ای (Comparison Operators) عملگرهای منطقی (Logical Operators) اولویت عملگرها (Operator Precedence) رشته ها (Swift Strings) اتصال رشته ها (Concatenation) اعداد و رشته ها (Numbers and Strings) کاراکترهای ویژه (Special Characters) یونیکد و اسکالرها (Unicode & Scalars) آرایه ها (Swift Arrays) حلقه روی آرایه (Loop Through an Array) برش های آرایه (Array Slices) اندیس ها و کران ها (Indices & Bounds) آرایه های چندبعدی (Multidimensional Arrays) نمونه های دنیای واقعی (Real-Life Examples) بازه ها (Swift Ranges) اگر...وگرنه (Swift If...Else) if (if) else (else) else if (else if) اگر...وگرنه کوتاه (Short Hand If...Else) if تو در تو (Nested If) عملگرهای منطقی (Logical Operators) نمونه های دنیای واقعی (Real-Life Examples) سوئیچ (Swift Switch) حلقه while (Swift While Loop) حلقه repeat/while (Repeat/While Loop) نمونه های دنیای واقعی (Real-Life Examples) حلقه for (Swift For Loop) حلقه های تو در تو (Nested Loops) حلقه for-each (For-Each Loop) نمونه های دنیای واقعی (Real-Life Examples) شکستن/ادامه (Swift Break/Continue) کالکشن ها (Swift Collections) ست ها (Sets) دیکشنری ها (Dictionaries) map، filter، reduce (map, filter, reduce) مرتب سازی (Sorting) تغییرپذیری (let دربرابر var) (Mutability (let vs var)) پروتکل های کالکشن (Collection Protocols) توابع (Swift Functions) اختیاری ها (Swift Optionals) enumها و الگوها (Swift Enums & Patterns) Closureها (Swift Closures) تاپل ها و نام های مستعار نوع (Tuples & Type Aliases) برنامه نویسی شیءگرا (Swift OOP) کلاس ها/اشیا (Classes/Objects) ساختارها (Structs) کلاس vs ساختار (Class vs Struct) ویژگی های کلاس (Class Properties) متدهای کلاس (Class Methods) کلیدواژه self (self Keyword) ارث بری (Swift Inheritance) چندریختی (Swift Polymorphism) پروتکل ها (Swift Protocols) جنریک ها (Swift Generics) اکستنشن ها (Swift Extensions) کنترل دسترسی (Access Control) سازنده ها (Initializers) مخرب ها (Deinitializers) معنای مقداری و COW (Value Semantics & COW) Equatable و Comparable (Equatable & Comparable) مدیریت خطا (Swift Error Handling) هم روندی (Swift Concurrency) حافظه (Swift Memory) مدیر بسته سوئیفت (Swift Package Manager) معرفی SwiftUI (SwiftUI Intro) راه اندازی پروژه iOS (iOS Project Setup) چیدمان SwiftUI (SwiftUI Layout) HStack VStack ZStack (HStack VStack ZStack) اسپیسر و ترازبندی (Spacers & Alignment) فریم و پدینگ (Frames & Padding) گریدها (Grids) GeometryReader (GeometryReader) ناحیه امن (Safe Area) استک های تنبل (Lazy Stacks) ناوبری SwiftUI (SwiftUI Navigation) NavigationStack (NavigationStack) NavigationLink (NavigationLink) TabView (TabView) شیت ها و پاپ اورها (Sheets & Popovers) دیپ لینک ها (Deep Links) ناوبری برنامه ای (Programmatic Nav) navigationDestination (navigationDestination) نوار ابزار و آیتم ها (Toolbar & Bar Items) جریان داده در SwiftUI (SwiftUI Data Flow) @State (@State) @Binding (@Binding) @ObservedObject & @StateObject (@ObservedObject & @StateObject) @EnvironmentObject (@EnvironmentObject) @Environment (Values) (@Environment (Values)) لیست ها و فرم ها در SwiftUI (SwiftUI Lists & Forms) List (List) ForEach (ForEach) Section (Section) Form (Form) TextField/Toggle/Picker (TextField/Toggle/Picker) Swipe Actions (Swipe Actions) Edit Mode (Edit Mode) List Styles (List Styles) انیمیشن ها در SwiftUI (SwiftUI Animations) انیمیشن های ضمنی (Implicit Animations) انیمیشن های صریح (Explicit Animations) ترنزیشن ها (Transitions) MatchedGeometryEffect (MatchedGeometryEffect) انیمیشن های فنری (Spring Animations) منحنی های انیمیشن (Animation Curves) ژست ها در SwiftUI (SwiftUI Gestures) TapGesture (TapGesture) LongPressGesture (LongPressGesture) DragGesture (DragGesture) ترکیب ژست ها (Composing Gestures) MagnificationGesture (MagnificationGesture) RotationGesture (RotationGesture) Modifierها و ViewBuilder (SwiftUI Modifiers & ViewBuilder) مودیفایرها (Modifiers) ViewBuilder (ViewBuilder) مودیفایرهای سفارشی (Custom Modifiers) پیش نمایش ها (SwiftUI Previews) گونه ها و وضعیت ها (Variants & States) حالت روشن/تیره (Light/Dark Mode) دسترس پذیری در SwiftUI (SwiftUI Accessibility) برچسب ها و عمل ها (Labels & Actions) سایز پویا (Dynamic Type) فوکوس و VoiceOver (Focus & VoiceOver) استایل دهی و تم دهی در SwiftUI (SwiftUI Styling & Theming) طرح های رنگی (Color Schemes) متریال ها (Materials) تم دهی (Theming) شبکه سازی (Networking) ماندگاری (Persistence) ماندگاری (Core Data) (Persistence (Core Data)) معماری MVVM (MVVM Architecture) AppStorage و SceneStorage (AppStorage & SceneStorage) تست SwiftUI (Testing SwiftUI) حریم خصوصی و مجوزها (Privacy & Permissions) اعلان های پوش (Push Notifications) ویجت ها و اکستنشن ها (Widgets & Extensions) کار در پس زمینه (Background Work) Core Location (Core Location) App Clips (App Clips) مبانی Keychain (Keychain Basics) CloudKit (CloudKit) سیستم فایل (File System) URLSession پس زمینه (Background URLSession) MapKit (MapKit) بومی سازی (Localization) دسترس پذیری (Accessibility) حریم خصوصی اپ (App Privacy) خرید درون برنامه ای (In-App Purchases) آنالیتیکس و گزارش گیری (Analytics & Reporting) تست با XCTest (Testing with XCTest) دارایی ها و آیکون ها (Assets & App Icons) امضا و انتشار (Signing & Distribution) TestFlight و App Store (TestFlight & App Store) انتشار اولین اپ (Ship Your First App) تمارین (Swift Exercises) کوییز (Swift Quiz)
نتیجه‌ای برای جستجو یافت نشد.
Swift

Swift — حریم خصوصی و مجوزها (Privacy & Permissions)

آخرین بروزرسانی: 1404/08/15

حریم خصوصی و مجوزها (Privacy & Permissions)

اینجا درباره «حریم خصوصی (Privacy)» و «مجوزها (Permissions)» حرف می زنیم. اول توضیح استفاده را در Info.plist بنویس. بعد، مجوز را در زمان اجرا بگیر. مثل اجازه گرفتن برای بردن گوشی به زنگ ورزش.

درخواست دسترسی دوربین

برای دوربین از AVCaptureDevice کمک بگیر. سپس وضعیت را چک کن. و در صورت نیاز درخواست بده.

  1. کلید توضیح استفاده را در Info.plist بگذار.
  2. وضعیت مجوز را بررسی کن.
  3. اگر نامشخص بود، درخواست بده.
import SwiftUI
import AVFoundation

struct CameraPermissionDemo: View {
  @State private var status: AVAuthorizationStatus = AVCaptureDevice.authorizationStatus(for: .video)
  var body: some View {
    VStack(spacing: 12) {
      Text("Status: \(label(for: status))")
      Button("Request Access") {
        AVCaptureDevice.requestAccess(for: .video) { _ in
          DispatchQueue.main.async {
            status = AVCaptureDevice.authorizationStatus(for: .video)
          }
        }
      }
    }
    .padding()
  }
  private func label(for s: AVAuthorizationStatus) -> String {
    switch s {
    case .notDetermined:
      return "notDetermined"
    case .denied:
      return "denied"
    case .restricted:
      return "restricted"
    case .authorized:
      return "authorized"
    @unknown default:
      return "unknown"
    }
  }
}

مشاهده در ادیتور

import SwiftUI

struct ContentView: View {
  var body: some View {
    CameraPermissionDemo()
  }
}

مشاهده در ادیتور

import SwiftUI

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
    }
  }
}

مشاهده در ادیتور

باز کردن تنظیمات برنامه

اگر کاربر رد کرد، مسیر تنظیمات را باز کن. سپس راهنمای روشن بده.

import SwiftUI
import UIKit

struct OpenSettingsDemo: View {
  var body: some View {
    VStack(spacing: 12) {
      Text("Permission denied? Open Settings.")
      Button("Open Settings") {
        if let url: URL = URL(string: UIApplication.openSettingsURLString) {
          if UIApplication.shared.canOpenURL(url) {
            UIApplication.shared.open(url)
          }
        }
      }
    }
    .padding()
  }
}

مشاهده در ادیتور

کلیدهای Info.plist برای حریم خصوصی

وقتی سراغ دوربین، میکروفن، موقعیت و… می روی، توضیح استفاده لازم است. این متن به کاربر نشان داده می شود.

NSCameraUsageDescription = "This app uses the camera to scan QR codes"
NSPhotoLibraryUsageDescription = "Select a profile picture"
NSLocationWhenInUseUsageDescription = "Find nearby stores"

مشاهده در ادیتور

الگوی عمومی درخواست مجوز

اول وضعیت را بخوان. سپس اگر لازم بود، درخواست بده. در حالت رد، مسیر جایگزین بده.

import AVFoundation

let status: AVAuthorizationStatus = AVCaptureDevice.authorizationStatus(for: .video)
switch status {
case .notDetermined:
  AVCaptureDevice.requestAccess(for: .video) { granted in
    // handle
  }
case .denied:
  // Show instructions to enable in Settings
  break
case .restricted:
  // Inform user about restrictions
  break
case .authorized:
  // Proceed to use camera
  break
@unknown default:
  break
}

مشاهده در ادیتور

لینک به تنظیمات در حالت رد

import UIKit

if let url: URL = URL(string: UIApplication.openSettingsURLString) {
  if UIApplication.shared.canOpenURL(url) {
    UIApplication.shared.open(url)
  }
}

مشاهده در ادیتور

مجوزهای رایج دیگر

عکس ها، موقعیت، میکروفن و مخاطبین نیز الگوی مشابهی دارند. فقط چارچوبشان فرق دارد.

import Photos

PHPhotoLibrary.requestAuthorization { status in
  // handle
}

مشاهده در ادیتور

import CoreLocation

class L: NSObject, CLLocationManagerDelegate {
  let manager: CLLocationManager = CLLocationManager()
  func ask() {
    manager.requestWhenInUseAuthorization()
  }
}

مشاهده در ادیتور

import AVFoundation

AVAudioSession.sharedInstance().requestRecordPermission { granted in
  // handle
}

مشاهده در ادیتور

import Contacts

let store: CNContactStore = CNContactStore()
store.requestAccess(for: .contacts) { granted, error in
  // handle
}

مشاهده در ادیتور

نکته: دلیل نیاز را کوتاه توضیح بده. در صورت رد، مسیر جایگزین بده. همچنین برای آزمون، سناریوهای همه وضعیت ها را پوشش بده.

جمع بندی سریع

  • حریم خصوصی یعنی احترام به داده کاربر.
  • توضیح استفاده در Info.plist الزامی است.
  • مجوز را زمان اجرا درخواست کن.
  • در حالت رد، تنظیمات را پیشنهاد بده.

نکته: ادامه مسیر: صفحه تست SwiftUI را ببین. همچنین ذخیره وضعیت را در AppStorage و SceneStorage مرور کن. برای معماری، به MVVM سر بزن. این ها با «حریم خصوصی» خوب جور می شوند.