Índice

Objetivo

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

...

• Componentes de interface como: botões, listas, visões, etc;
• Telas completas como Login, Timeline, Process, etc.

é auxiliar na criação de aplicativos móveis da plataforma fluig de forma simples e eficiente. Provendo facilitadores como mapeamento de chamadas de APIs, componentes de interfaces, fluxos integrados, ferramentas, etc.

Requisitos

Para utilizar o SDK iOS, certifique-se que seu projeto atende os seguintes requisitos mínimos:

• iOS 10.3+
• Swift 4.1+
• Xcode 9.2+

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.1 Importar via CocoaPods
   1.2 Importar manualmente
2. Adicionar um arquivo de configuração
3. Utilizar o fluxo de login

Importar o SDK no seu projeto 

Âncora
importar importar

É possível importar o SDK de duas maneiras, via CocoaPods ou manualmente. É recomendada a importação via CocoaPods por ser a opção mais simples.

Importar via CocoaPods 

Âncora
cocoa cocoa

Caso não esteja familiarizado com o CocoaPods, siga os passos descritos na documentação para criar o arquivo Podfile necessário.

Insira a dependência do SDK no arquivo Podfile criado. O exemplo abaixo irá adicionar todos os subspecs do SDK.

target 'MyApp' do
  use_frameworks!

  # Pods for MyApp
  pod 'fluigsdk', { :git => 'https://github.com/fluig/fluigsdkios', :tag => '0.2.1' }

  target 'MyAppTests' do
    inherit! :search_paths
    # Pods for testing
  end

end

Caso deseje importar somente um conjunto de subspecs específico, altere a dependência do seu Podfile.

# Pods for MyApp
pod 'fluigsdk/<subspec_desejado>', { :git => 'https://github.com/fluig/fluigsdkios', :tag => '0.2.1' }

Importar manualmente 

Âncora
manualmente manualmente

Faça o download do SDK e adicione os arquivos framework no seu projeto.

Para evitar problemas na importação manual, arraste os arquivos framework para dentro do Xcode na seção Embedded Binaries do target do seu projeto. Confira abaixo como efetuar esta etapa.

Image Added

Adicionar um arquivo de configuração 

Âncora
arquivo arquivo

Qualquer configuração que o SDK necessite no momento da inicialização do seu aplicativo deve estar localizada em um arquivo de configuração dentro do seu projeto. Este arquivo deve ser do tipo property list 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>

Caso esteja mais familiarizado com o editor padrão de property lists do Xcode, confira abaixo o mesmo exemplo de fluigSdk.plist.

Image Added

Utilizar o fluxo de login 

Âncora
login 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. 

Requisitos

Os requisitos necessários são:

• iOS 9.0+
• Xcode 8.1+
• Swift 3.0+

Configuração

1. Configuração do aplicativo para iOS;
2. Integrar fluigSDK no seu aplicativo;
3. Chamando o fluigSDK do App Delegate.

Configuração do aplicativo para iOS

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 "fluigSDKConfiguration.plist"

Integrar fluigSDK no seu aplicativo

Você pode instalar o SDK usando CocoaPods ou manualmente.

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;
}

Como usar

...

• Processes
• Documents
• Socual

...