Instalação do SDK Swift
Instale o SDK Swift com o Swift Package Manager e inicialize-o com o ID do projeto da UserJot durante a inicialização do app.
Requisitos
iOS 15.0+ ou macOS 12.0+
Swift 6.1+
Xcode 16.3+
Instalar com o Swift Package Manager
No Xcode
Abra seu projeto no Xcode.
Acesse Arquivo → Adicionar Dependências de Pacote.
Insira este URL do pacote:
https://github.com/UserJot/userjot-iosAdicione o pacote
UserJotao target do app.
No Package.swift
dependencies: [
.package(url: "https://github.com/UserJot/userjot-ios", from: "0.4.0")
]Encontre seu ID do projeto
Abra Configurações → Login no painel da UserJot e copie o ID do projeto na seção Segredos.
Inicialize o SDK
Chame UserJot.setup(projectId:) uma vez na inicialização do app:
SwiftUI
import SwiftUI
import UserJot
@main
struct MyApp: App {
init() {
UserJot.setup(projectId: "YOUR_PROJECT_ID")
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}UIKit
import UIKit
import UserJot
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
) -> Bool {
UserJot.setup(projectId: "YOUR_PROJECT_ID")
return true
}
}Verifique a integração
setup retorna imediatamente e carrega o endereço do seu board em segundo plano. Qualquer chamada a show aguarda esse carregamento antes de apresentar o conteúdo e tenta novamente se o dispositivo estava offline na inicialização.
Button("Send Feedback") {
UserJot.showFeedback()
}Os auxiliares de URL (feedbackURL(board:), roadmapURL(), updatesURL()) são async pelo mesmo motivo e retornam nil se não for possível carregar o endereço.
Entitlements do macOS
Em apps do macOS em sandbox, habilite o acesso de saída à rede nos entitlements do app:
<key>com.apple.security.network.client</key>
<true/>Migração da versão 0.3
showChangelog()agora éshowUpdates(), echangelogURL()agora éupdatesURL()(os nomes antigos geram um aviso de descontinuação e serão removidos na versão 1.0).feedbackURL(board:),roadmapURL()eupdatesURL()agora sãoasync.UserJotagora é isolado no ator principal; useawaitem chamadas feitas em tarefas em segundo plano.As plataformas mínimas são iOS 15 e macOS 12.
Próximas etapas
Identifique os usuários conectados em Autenticação.
Apresente feedback, roteiro e atualizações em Fluxos comuns.