Migrar para GMSPlaceField como NS_OPTIONS

A partir da versão 4.0.0 do SDK do Places para iOS, o tipo GMSPlaceField agora usa a macro NS_OPTIONS. As versões 3.x do SDK têm GMSPlaceField como NS_ENUM e ainda têm suporte.

  • Se você estiver usando Objective-C:não há implicações. Você pode continuar usando GMSPlaceField como antes.

  • Se você estiver usando o Swift:sua implementação será interrompida se você estiver usando a sintaxe GMSPlaceField(rawValue:) como o construtor, que as versões mais antigas do SDK retornam como um GMSPlaceField? opcional. A versão 4.0.0 e mais recentes retornam um valor GMSPlaceField não opcional. Todas as operações realizadas no opcional, como verificações condicionais ou desempacotamento forçado, vão falhar. Além disso, agora você pode usar a sintaxe de matriz para combinar GMSPlaceFields

Migrar o código

Algumas sintaxe de desempacotamento condicional ou forçado serão interrompidas no Swift. Os exemplos a seguir mostram como corrigir esses problemas e também demonstram o uso da sintaxe de matriz para declarar GMSPlaceField:

Descompactação condicional

A instrução no exemplo a seguir mostra o uso de if para criar uma matriz GMSPlaceField que exige desempacotamento condicional. Isso resultará em um erro do compilador ("O inicializador para vinculação condicional precisa ter o tipo Opcional, não GMSPlaceField").

// Before.
if let field = GMSPlaceField(
    rawValue: GMSPlaceField.name.rawValue | GMSPlaceField.photos.rawValue
) { // Do something }

Para corrigir esse problema, remova a instrução if, conforme mostrado aqui:

// After.
let field =  GMSPlaceField(
    rawValue: GMSPlaceField.name.rawValue | GMSPlaceField.photos.rawValue
)
// Do something

Você também pode usar a sintaxe de matriz, conforme mostrado aqui:

let field = [GMSPlaceField.name, GMSPlaceField.photos]
// or
let field: GMSPlaceField = [.name, .photos]

Forçar o desempacotamento

A instrução no exemplo a seguir mostra o uso de GMSPlaceField como um tipo não opcional. Isso vai resultar em um erro do compilador ("Não é possível forçar o desempacotamento do valor do tipo não opcional GMSPlaceField"):

// Before.
let field = GMSPlaceField(
    rawValue: GMSPlaceField.name.rawValue | GMSPlaceField.photos.rawValue
)!

Para corrigir esse problema, use GMSPlaceField como um tipo opcional, conforme mostrado aqui:

// After.
let field =  GMSPlaceField(
    rawValue: GMSPlaceField.name.rawValue | GMSPlaceField.photos.rawValue
)

Você também pode usar a sintaxe de matriz, conforme mostrado aqui:

let field = [GMSPlaceField.name, GMSPlaceField.photos]
// or
let field: GMSPlaceField = [.name, .photos]