Índice

O fluig SDK para iOS é a maneira mais fácil de integrar seu aplicativo com a plataforma do fluig e está dividido em camadas:

• fluigSDKCore: Acesso a todas as APIs REST automaticamente assinadas usando OAuth.
• fluigSDKFlows: API + camada de negócio.  Disponibilizando:
  • Banco de dados;
  • Cache;
  • Gerenciamento de servidores e usuários.
    
    
• fluigSDKUi: Camada de negócio + camada de interface do usuário. Disponibilizando:
  • Componentes de interface como: botões, listas, visões, etc;
  • Telas completas como Login, Timeline, Process, etc.

Requisitos

Os requisitos necessários são:

• iOS 10.0+
• Swift 4.0+
• Xcode 9.0+

Instalação

Para instalar o SDK em seu projeto, é necessário seguir os passos descritos a seguir:

1. Importar o SDK no seu projeto
   1. Importar por CocoaPods
   2. Importar manualmente
2. Adicionar um arquivo de configuração
3. Utilizar o fluxo de login

Importar o SDK no seu projeto

É possível importar o SDK

1. Localize o identificador do seu bundle no Xcode e copie-o para a área de transferência.
   (incluir imagem)
2. Crie uma nova aplicação dentro do seu painel do desenvolvedor
3. Cole o identificador do bundle dentro do painel do desenvolvedor e faça o download do seu arquivo "fluigSdk.plist"

Adicionar um arquivo de configuração

Qualquer configuração que o SDK necessite no momento de inicialização do seu aplicativo deve estar localizada em um arquivo de configuração dentro do seu projeto. Este arquivo deve ser do tipo plist e ser chamado fluigSdk.

Atualmente a principal função deste arquivo é fornecer as chaves responsáveis pela renovação do token de acesso às APIs do fluig. Para criar as chaves que serão fornecidas no arquivo de configuração, siga os passos descritos em Criar Usuário Aplicativo.

O exemplo abaixo demonstra como deve ser a formatação do arquivo plist.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>consumerKey</key>
	<string>my_consumer_key</string>
	<key>consumerSecret</key>
	<string>my_consumer_secret</string>
</dict>
</plist>

Utilizar o fluxo de login

Este passo é opcional mas altamente recomendado devido a complexidade do fluxo de login. Acesse a documentação e obtenha todas as informações necessárias para adicionar este recurso ao seu projeto. 

CocoaPods

CocoaPods é um gerenciador de dependências para projetos Cocoa. Você pode instalá-lo com o seguinte comando:

$ gem install cocoapods

Para integrar o fluigSDK no seu Xcode usando CocoaPods, adicione-o no seu Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'fluigSDK'
end

Então execute o seguinte comando:

$ pod install

Manualmente

Você também pode integrar o fluigSDK manualmente no seu projeto baixando os pacotes da página do fluigSDK para iOS(inserir link) e adicione os arquivos .framework no seu projeto.

Chamando o fluigSDK do App Delegate

Objective-C

//  AppDelegate.m

#import <FBSDKCoreKit/FBSDKCoreKit.h>

- (BOOL)application:(UIApplication *)application 
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
  
  
  return YES;
}

Swift

//  AppDelegate.m

import FBSDKCoreKit

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey : Any]? = nil) -> Bool {
  
  
  
  return true;
}