Objective-C

Sync an FTP Directory Tree Down to Local

Demonstrates the Chilkat Ftp2.SyncLocalTree method, which synchronizes the remote tree rooted at the current remote directory into a local directory. The first argument is the local root and the second is the download mode, which selects which files are transferred (all, only-missing, only-newer, different-size, and so on).

Note: The local paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.

Background: Where DownloadTree copies everything, SyncLocalTree transfers only what the mode says needs updating — the key to fast incremental refreshes that skip unchanged files. Timestamp-based modes rely on comparable clocks between systems, while the size-difference modes catch changed files even when timestamps are unreliable across platforms. Mode 99 flips the direction entirely, deleting local files absent from the server. Use GetSyncedFiles afterward to see exactly what changed.

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoFtp2.h>

BOOL success = NO;

//  Demonstrates the Ftp2.SyncLocalTree method, which synchronizes the remote tree rooted at the
//  current remote directory into a local directory.  The 1st argument is the local root and the
//  2nd is the download mode.

CkoFtp2 *ftp = [[CkoFtp2 alloc] init];

ftp.Hostname = @"ftp.example.com";
ftp.Username = @"myFtpLogin";

//  Normally you would not hard-code the password in source.  You should instead obtain it
//  from an interactive prompt, environment variable, or a secrets vault.
ftp.Password = @"myPassword";

success = [ftp Connect];
if (success == NO) {
    NSLog(@"%@",ftp.LastErrorText);
    return;
}

success = [ftp ChangeRemoteDir: @"public_html"];
if (success == NO) {
    NSLog(@"%@",ftp.LastErrorText);
    return;
}

//  Download mode selects which files are transferred:
//    0 = all selected files
//    1 = files missing locally
//    2 = missing locally, or newer on the server
//    3 = only files that exist locally and are newer on the server
//    5 = missing locally, or a different size
//    6 = missing, different size, or newer on the server
//   99 = do not download; delete local... (see docs)

int mode = 6;
success = [ftp SyncLocalTree: @"qa_output/site" mode: [NSNumber numberWithInt: mode]];
if (success == NO) {
    NSLog(@"%@",ftp.LastErrorText);
    return;
}

NSLog(@"%@",@"Remote tree synced to local.");

success = [ftp Disconnect];
if (success == NO) {
    NSLog(@"%@",ftp.LastErrorText);
    return;
}