backgroundassets 0.3.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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

use backgroundassets::{
    install_global_managed_downloader_extension, AppExtensionInfo, AssetPackSnapshot,
    AuthenticationChallenge, ChallengeDisposition, ContentRequest, Download,
    DownloadManagerDelegate, DownloadSnapshot, DownloadWriteProgress, DownloaderExtensionHandler,
    ManagedDownloaderExtensionConfiguration, UrlDownload,
};

struct ExampleExtension;

impl DownloaderExtensionHandler for ExampleExtension {
    fn should_download_asset_pack(&mut self, asset_pack: &AssetPackSnapshot) -> bool {
        println!("considering managed asset pack {} v{}", asset_pack.id, asset_pack.version);
        true
    }

    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
    }
}

struct ExampleDownloadManagerDelegate;

impl DownloadManagerDelegate for ExampleDownloadManagerDelegate {
    fn download_did_begin(&mut self, download: &DownloadSnapshot) {
        println!("managed download began: {}", download.identifier);
    }

    fn download_did_write_bytes(
        &mut self,
        download: &DownloadSnapshot,
        progress: &DownloadWriteProgress,
    ) {
        println!(
            "managed download progress: {} {}/{}",
            download.identifier,
            progress.total_bytes_written,
            progress.total_bytes_expected_to_write
        );
    }
}

fn main() {
    let configuration = ManagedDownloaderExtensionConfiguration::new(ExampleDownloadManagerDelegate)
        .extension_event_capacity(16)
        .download_manager_event_capacity(16);
    let registration = install_global_managed_downloader_extension(ExampleExtension, configuration);

    println!("Registered Rust managed downloader extension handler.");
    println!(
        "Set EXPrincipalClass to BackgroundAssetsRustManagedDownloaderExtension in your extension Info.plist."
    );
    println!(
        "Extension stream closed? {} | download-manager stream closed? {}",
        registration.extension_events().is_closed(),
        registration.download_manager_events().is_closed()
    );
}