Criar um aplicativo Hello World para iOS

OK. Você está convencido de que o SDK de serviço incorporado é o ideal. Você está empolgado com a possibilidade de usar o SDK para conectar recursos incríveis do Service Cloud a seu aplicativo. Já preparou sua organização para usar o SDK. Nesta unidade, vamos mostrar como você pode fazer isso tudo funcionar rapidamente em seu aplicativo iOS para iPhone e iPad já criado.

Nota

Esta unidade pressupõe que você está familiarizado com desenvolvimento em iOS. Não vamos ensiná-lo a usar Swift ou o IDE do Xcode. Se você não sabe usar essas coisas, percorra a unidade para ter uma ideia dos benefícios de usar esse SDK.

Agora você está pronto para criar um projeto simples. Comece iniciando o Xcode e criando um Aplicativo de visualização única. Use o Xcode versão 9 ou posterior.

Neste exemplo, vamos ser práticos e usar a linguagem Swift.

Em seguida, baixe o SDK de serviço incorporado na página de download do SDK de serviço.

Descompacte o SDK e incorpore todos os arquivos de estrutura incluídos em seu projeto.

Se preferir usar CocoaPods para instalar o SDK ou quiser saber exatamente quais estruturas são necessárias para seu caso de uso, confira as instruções de instalação do SDK (consulte a seção Recursos).

Vamos organizar melhor antes de adicionar nosso lindo botão. Precisamos criar uma exceção App Transport Security (ATS) para localhost a fim de servir os artigos da base de conhecimento em cache. Abra o arquivo Info.plist de seu projeto e adicione o conteúdo a seguir.

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSExceptionDomains</key>
  <dict>
    <key>localhost</key>
    <dict>
      <key>NSExceptionAllowsInsecureHTTPLoads</key>
      <true/>
    </dict>
  </dict>
</dict>

Vamos adicionar um botão de ajuda a seu controlador de visualização principal.

Arraste um botão para seu controlador de visualização. Renomeie o botão como algo útil, por exemplo: O SDK de serviço é ótimo!.

Alinhe o botão com outras visualizações para que ele fique posicionado corretamente em todos os dispositivos compatíveis.

Agora crie um método de ação para o botão em nosso controlador de visualização e dê o nome de buttonTapped.

OK. Agora vamos seguir para a programação! Vamos ver o recurso Knowledge, mas você poderá experimentar qualquer outro recurso se preferir.

Primeiro, abra sua classe AppDelegate e importe as estruturas necessárias:

import ServiceCore
import ServiceKnowledge

Configure seu SDK no método application(_:didFinishLaunchingWithOptions:):

// Create configuration object with init params
let config = SCSServiceConfiguration(
               community: URL(string: "https://mysite.example.com")!,
               dataCategoryGroup: "Regions",
               rootDataCategory: "All")
// Pass configuration to shared instance
ServiceCloud.shared().serviceConfiguration = config

Não deixe de substituir os valores de espaço reservado pelos valores reais de sua URL do site do Experience Cloud, de seu grupo de categoria de dados e da categoria de dados raiz. Se não fizer isso, seu aplicativo ficará muito triste quando não encontrar nenhum conteúdo do Knowledge. Para obter mais orientações, confira a Configuração do Cloud para o Knowledge na seção Recursos.

Agora vamos passear até a classe ViewController e fazer o botão, além de atrativo, ser útil.

Precisamos importar nossas estruturas também nesse arquivo.

import ServiceCore
import ServiceKnowledge

Em seguida, vamos iniciar a interface do Knowledge diretamente no manipulador do botão criado anteriormente usando o método setInterfaceVisible.

@IBAction func buttonTapped(_ sender: AnyObject) {
  ServiceCloud.shared().knowledge.setInterfaceVisible(true,
                                  animated: true,
                                  completion: nil)
}

E é isso. Inicie o aplicativo, toque em nosso novo botão e desfrute de sua glória com o Knowledge.

Muito legal, não é? Daqui é possível fazer várias outras coisas. É possível adicionar imagens principais a qualquer categoria ou artigo. Você pode refazer as cores, o texto da interface de usuário, as fontes e as imagens usadas na interface. Fique tranquilo: trabalhar com o gerenciamento de casos ou com o bate-papo é tão fácil quanto trabalhar com o Knowledge.

Você não sabe o que é isso? Como é possível arranjar mais informações?

Bem, você pode começar com o guia do desenvolvedor do SDK de serviço incorporado para iOS. Ele contém mais tutoriais, mais exemplos e trata de muitos outros tópicos. Ele dá informações sobre todas as principais áreas de recursos: Knowledge, gerenciamento de casos e bate-papo. Também é possível consultar a documentação de referência para iOS para ver detalhes sobre a API. Encontre links para essas e outras excelentes ferramentas na seção Recursos.

Em seguida, veremos como criar um aplicativo semelhante para Android.