Guides

Best Practices

1. SDK Initialization

  • Initialize the SDK once in your app's lifecycle (AppDelegate or App struct)
  • Store the SDK instance for reuse throughout the app
  • Handle initialization errors gracefully

2. Memory Management

  • Use [weak self] in completion handlers to avoid retain cycles
  • Properly manage SDK instances and avoid creating multiple instances

3. Threading

  • Always update UI on the main thread
  • SDK callbacks may come on background threads
  • Use DispatchQueue.main.async for UI updates

4. Caching

  • Use the disableCache parameter appropriately
  • Enable caching for frequently accessed data
  • Disable caching for real-time data

5. Error Handling

  • Always handle errors in completion handlers
  • Provide user-friendly error messages
  • Implement retry mechanisms for network failures

6. Performance

  • Use filters to limit data requests
  • Implement pagination for large datasets
  • Cache responses when appropriate

Key Implementation Patterns

Authentication Provider

class AuthProvider: IFUSDKTokenProvider {
    func getToken() async throws -> String? {
        // Implement your authentication logic
        // Return JWT token or similar
    }

    func logout() async throws {
        // Handle logout cleanup
    }
}

SDK Configuration

let config = FUSDKConfig(
    apiKey: "your-api-key",
    clientId: "your-client-id",
    lang: "en",
    idSchema: IDSchema.sportal365,
    environment: "prod",
    authProvider: AuthProvider()
)

let sdk = FansUnitedSDK.Companion.shared.doInit(config: config)

Data Fetching Pattern

// Create filters
let filters = MatchFilters(
    countryIds: nil,
    competitionIds: nil,
    matchIds: nil,
    status: nil,
    teamIds: nil,
    fromDate: todayInstant,
    toDate: nil,
    limit: 50,
    page: nil,
    sortField: nil,
    sortOrder: nil
)

// Fetch data directly from SDK
let matches = try await sdk.football().getMatches(filters: filters, disableCache: false)?.data