backgroundassets 0.2.0

Safe Rust bindings for Apple's BackgroundAssets framework — on-demand asset packs delivered via App Store on macOS
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

use backgroundassets::{
    install_global_downloader_extension, AppExtensionInfo, AuthenticationChallenge,
    ChallengeDisposition, ContentRequest, Download, DownloaderExtensionHandler, UrlDownload,
};

struct ExampleExtension;

impl DownloaderExtensionHandler for ExampleExtension {
    fn downloads(
        &mut self,
        request: ContentRequest,
        manifest_url: &str,
        extension_info: &AppExtensionInfo,
    ) -> Result<Vec<Download>, backgroundassets::BackgroundAssetsError> {
        println!(
            "request={request:?} manifest={manifest_url} remaining={:?}",
            extension_info.restricted_download_size_remaining()
        );

        let download = UrlDownload::new(
            "com.example.backgroundassets.sample",
            "https://example.com/assets/sample.bin",
            1024,
            "group.com.example.backgroundassets",
        )?;
        Ok(vec![download.into_download()])
    }

    fn did_receive_challenge(
        &mut self,
        _download: &Download,
        challenge: &AuthenticationChallenge,
    ) -> ChallengeDisposition {
        println!(
            "challenge host={} method={}",
            challenge.host, challenge.authentication_method
        );
        ChallengeDisposition::PerformDefaultHandling
    }
}

fn main() {
    let events = install_global_downloader_extension(ExampleExtension, 16);
    println!("Registered Rust downloader extension handler.");
    println!(
        "Set EXPrincipalClass to BackgroundAssetsRustDownloaderExtension in your extension Info.plist."
    );
    println!("Event stream closed? {}", events.is_closed());
}