Export and import messages
Overview
With the ZIM SDK, you can export the local chat history (one-to-one messages and group messages) of the current user's client as a backup. This backup can be used to migrate chat history when changing devices or to restore deleted messages.
Export messages
After creating a ZIM object and logging in, you can call the exportLocalMessages interface by providing an absolute path to save the chat messages of the current user to that directory.
The progress of the export will be returned through the ZIMMessageExportingProgress callback interface.
The result of the export operation will be returned through the ZIMMessageExportedCallback callback interface.
The result of the export operation will be returned through the ZIMMessageExportedCallback callback interface.
The result of the export operation will be returned through the ZIMMessageExportedCallback callback interface.
The exported message file name for this interface is zim_backup_msg_text. If the same path is provided in multiple calls to this interface, the ZIM SDK will automatically rename the old zim_backup_msg_text file to ensure that the latest exported file retains the name zim_backup_msg_text.
ZIMMessageExportConfig config = new ZIMMessageExportConfig();
zim.exportLocalMessages("folderPath", config, new ZIMMessageExportedCallback() {
@Override
public void onMessageExportingProgress(long exportedMessageCount, long totalMessageCount) {
}
@Override
public void onMessageExported(ZIMError errorInfo) {
}
});
1
try {
ZIMMessageExportConfig config = ZIMMessageExportConfig();
await ZIM.getInstance()!.exportLocalMessages('folderPath', config, (exportedMessageCount, totalMessageCount) {
});
} on PlatformException catch (onError) {
onError.code;
onError.message;
}
1
var progress = (exportedMessageCount, totalMessageCount) => {};
var folderPath = '/sdcard/xxxx';
zim.exportLocalMessages(folderPath, {}, progress)
.then(function () {
})
.catch(function (err) {
});
1
zim::ZIMMessageExportConfig config;
zim::ZIM::getInstance()->exportLocalMessages("folderPath", config, [](unsigned long long exportedMessageCount,
unsigned long long totalMessageCount) {
}, [](const zim::ZIMError& errorInfo) {
});
1
ZIMMessageExportConfig *config = [[ZIMMessageExportConfig alloc] init];
[self.zim exportLocalMessagesToFolderPath:@"folderPath" config: config
progress:^(unsigned long long exportedMessageCount,
unsigned long long totalMessageCount) {
} callback:^(ZIMError *errorInfo) {
}];
1
Import messages
After creating a ZIM object and logging in, you can call the importLocalMessages interface by providing the absolute path of the directory where the backup file is located. This will import the messages.
By default, the ZIM SDK reads the file with the name "zim_backup_msg_text" in the specified directory. If there are multiple backups in that path, please ensure that the file you want to import is named "zim_backup_msg_text".
The progress of the import will be returned through the ZIMMessageImportingProgress callback interface.
The result of the import operation will be returned through the ZIMMessageImportedCallback interface.
The result of the import operation will be returned through the ZIMMessageImportedCallback interface.
The result of the import operation will be returned through the ZIMMessageImportedCallback interface.
ZIMMessageImportConfig config = new ZIMMessageImportConfig();
zim.importLocalMessages("folderPath", config, new ZIMMessageImportedCallback() {
@Override
public void onMessageImportingProgress(long importedMessageCount, long totalMessageCount) {
}
@Override
public void onMessageImported(ZIMError errorInfo) {
}
});
1
try {
ZIMMessageImportConfig config = ZIMMessageImportConfig();
var result = await ZIM.getInstance()!.importLocalMessages('folderPath', config, (importedMessageCount, totalMessageCount) {
});
} on PlatformException catch (onError) {
onError.code;
onError.message;
}
1
var progress = (importedMessageCount, totalMessageCount) => {};
var folderPath = '/sdcard/xxxx';
zim.importLocalMessages(folderPath, {}, progress)
.then(function () {
})
.catch(function (err) {
});
1
zim::ZIMMessageImportConfig config;
zim::ZIM::getInstance()->importLocalMessages("folderPath", config, [](unsigned long long importedMessageCount,
unsigned long long totalMessageCount) {
}, [](const zim::ZIMError& errorInfo) {
});
1
ZIMMessageImportConfig *config = [[ZIMMessageImportConfig alloc] init];
[self.zim importLocalMessagesToFolderPath:@"folderPath" config: config
progress:^(unsigned long long importedMessageCount,
unsigned long long totalMessageCount) {
} callback:^(ZIMError *errorInfo) {
1
