Swift Academy · Lezione

UIViewRepresentable: racchiudere le view UIKit

Implementare makeUIView, updateUIView e lo smantellamento delle view UIKit in SwiftUI.

Lezione 1 di 413 passaggi

UIViewRepresentable: racchiudere le view UIKit è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 4 lezioni in totale.

Perché UIViewRepresentable?

Molte viste UIKit non hanno ancora un equivalente in SwiftUI. UIViewRepresentable collega le viste UIKit a SwiftUI.

import SwiftUI
import UIKit

struct WebView: UIViewRepresentable {
  let url: URL
  // ...
}

Metodi obbligatori

Implementi makeUIView per creare la vista e updateUIView per sincronizzare le modifiche dello stato di SwiftUI.

func makeUIView(context: Context) -> WKWebView {
  WKWebView()
}
func updateUIView(_ uiView: WKWebView, context: Context) {
  uiView.load(URLRequest(url: url))
}

Esempio completo di WebView

Un UIViewRepresentable completo che avvolge WKWebView per visualizzare contenuti web in SwiftUI.

struct WebView: UIViewRepresentable {
  let url: URL
  func makeUIView(context: Context) -> WKWebView { WKWebView() }
  func updateUIView(_ uiView: WKWebView, context: Context) {
    uiView.load(URLRequest(url: url))
  }
}

Utilizzo in SwiftUI

Utilizzi la vista avvolta come una qualsiasi vista SwiftUI e applichi normalmente i modificatori.

WebView(url: URL(string: "https://apple.com")!)
  .frame(height: 400)
  .cornerRadius(12)

Passaggio dei dati

Passi i dati da SwiftUI a UIKit tramite le proprietà memorizzate del representable, aggiornate in updateUIView.

struct MapView: UIViewRepresentable {
  var region: MKCoordinateRegion
  func makeUIView(context: Context) -> MKMapView { MKMapView() }
  func updateUIView(_ uiView: MKMapView, context: Context) {
    uiView.setRegion(region, animated: true)
  }
}

Rimozione delle viste UIKit

Implementi il metodo facoltativo dismantleUIView per liberare risorse, come gli observer, quando la vista viene rimossa.

static func dismantleUIView(_ uiView: WKWebView, coordinator: Coordinator) {
  uiView.stopLoading()
}

Parametro Context

Il context consente di accedere al coordinator, all'ambiente e alla transazione di animazione.

func updateUIView(_ uiView: MKMapView, context: Context) {
  print(context.environment.colorScheme)  // .light or .dark
}

Valori dell'ambiente in UIViewRepresentable

Legga i valori dell'ambiente SwiftUI da context.environment per adattare la configurazione UIKit.

if context.environment.colorScheme == .dark {
  uiView.overrideUserInterfaceStyle = .dark
}

Dimensionamento delle viste UIKit

UIViewRepresentable utilizza la dimensione intrinseca del contenuto o i modificatori frame di SwiftUI. Implementi sizeThatFits per un dimensionamento personalizzato.

func sizeThatFits(_ proposal: ProposedViewSize, uiView: WKWebView, context: Context) -> CGSize? {
  CGSize(width: proposal.width ?? 300, height: 400)
}

Evitare effetti collaterali in makeUIView

Mantenga makeUIView puro: si limiti a creare e configurare la vista. Inserisca gli aggiornamenti guidati dallo stato in updateUIView.

// WRONG:
func makeUIView(context: Context) -> MKMapView {
  let v = MKMapView()
  v.setRegion(region, animated: false)  // belongs in updateUIView
  return v
}

Viste avvolte comuni

Viste UIKit tipicamente avvolte con UIViewRepresentable: WKWebView, MKMapView, UITextView, UIImagePickerController, AVPlayerLayer.

// UITextView with custom toolbar
struct RichTextEditor: UIViewRepresentable {
  @Binding var text: String
  // makeUIView, updateUIView, Coordinator...
}

Verifica rapida

Quale metodo di UIViewRepresentable viene chiamato per sincronizzare lo stato di SwiftUI con la vista UIKit dopo la creazione iniziale?

Riepilogo della lezione

UIViewRepresentable richiede makeUIView (creazione una tantum) e updateUIView (sincronizzazione al variare dello stato). Utilizzi context.environment per adattare l'aspetto. Esegua la pulizia in dismantleUIView. Applichi i modificatori frame di SwiftUI per controllare il dimensionamento.

Gratis per iniziare

Impara Swift con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi
122
Lezioni
409

Domande Frequenti

La lezione «UIViewRepresentable: racchiudere le view UIKit» è gratuita?

Sì — il testo completo di «UIViewRepresentable: racchiudere le view UIKit» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 4 lezioni in totale.

Cosa imparerò in «UIViewRepresentable: racchiudere le view UIKit»?

Implementare makeUIView, updateUIView e lo smantellamento delle view UIKit in SwiftUI. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Swift Academy?

Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «UIViewRepresentable: racchiudere le view UIKit»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Swift Academy?

Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. UIViewRepresentable: racchiudere le view UIKit
  2. Pattern Coordinator per la comunicazione con i delegate
  3. UIViewControllerRepresentable
  4. UIHostingController: SwiftUI dentro UIKit
← Torna a Swift Academy