browserserviceskit-integration

BrowserServicesKit Integration Guide

Overview

BrowserServicesKit is the core shared library providing essential browser functionality to both iOS and macOS DuckDuckGo applications. It ensures consistent behavior and code reuse across platforms while maintaining privacy as the primary focus.

Core Modules and Usage

Privacy & Protection

Always use BrowserServicesKit for privacy-related functionality:

// ✅ CORRECT - Content blocking integration
import BrowserServicesKit
import ContentBlocking

final class PrivacyManager {
    private let contentBlockingManager = ContentBlockingManager.shared
    
    func enableContentBlocking(for webView: WKWebView) {
        contentBlockingManager.enable(for: webView)
    }
    
    func updateBlockingRules() async {
        await contentBlockingManager.updateRules()
    }
}

// ✅ CORRECT - Privacy configuration
import PrivacyConfig

final class PrivacyFeatureManager {
    private let privacyConfig = PrivacyConfiguration.shared
    
    func isFeatureEnabled(_ feature: PrivacyFeature) -> Bool {
        return privacyConfig.isEnabled(feature)
    }
}

Data Management

Use BrowserServicesKit for all data persistence:

// ✅ CORRECT - Bookmarks management
import Bookmarks

final class BookmarkService {
    private let bookmarkManager = BookmarkManager.shared
    
    func saveBookmark(_ bookmark: Bookmark) async {
        await bookmarkManager.save(bookmark)
    }
    
    func fetchBookmarks() async -> [Bookmark] {
        return await bookmarkManager.fetchAll()
    }
}

// ✅ CORRECT - Secure credential storage
import SecureVault

final class CredentialManager {
    private let secureVault = SecureVault.shared
    
    func storeCredential(_ credential: WebsiteCredential) async throws {
        try await secureVault.store(credential)
    }
    
    func retrieveCredentials(for domain: String) async throws -> [WebsiteCredential] {
        return try await secureVault.credentials(for: domain)
    }
}