public static void Save(Book.Book book, BookServer bookServer, Color backColor, WebSocketProgress progress, AndroidPublishSettings settings = null)
{
var progressWithL10N = progress.WithL10NPrefix("PublishTab.Android.File.Progress.");
var folder = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
if (!string.IsNullOrWhiteSpace(Settings.Default.BloomDeviceFileExportFolder) && Directory.Exists(Settings.Default.BloomDeviceFileExportFolder))
{
folder = Settings.Default.BloomDeviceFileExportFolder;
}
var initialPath = Path.Combine(folder, book.Storage.FolderName + BookCompressor.BloomPubExtensionWithDot);
var bloomdFileDescription = LocalizationManager.GetString("PublishTab.Android.bloomdFileFormatLabel", "Bloom Book for Devices",
"This is shown in the 'Save' dialog when you save a bloom book in the format that works with the Bloom Reader Android App");
var filter = $"{bloomdFileDescription}|*{BookCompressor.BloomPubExtensionWithDot}";
var destFileName = Utils.MiscUtils.GetOutputFilePathOutsideCollectionFolder(initialPath, filter);
if (String.IsNullOrEmpty(destFileName))
{
return;
}
Settings.Default.BloomDeviceFileExportFolder = Path.GetDirectoryName(destFileName);
PublishToAndroidApi.CheckBookLayout(book, progress);
PublishToAndroidApi.SendBook(book, bookServer, destFileName, null,
progressWithL10N,
(publishedFileName, bookTitle) => progressWithL10N.GetMessageWithParams("Saving", "{0} is a file path", "Saving as {0}", destFileName),
null,
backColor,
settings: settings);
PublishToAndroidApi.ReportAnalytics("file", book);
}
public static void Save(Book.Book book, BookServer bookServer, Color backColor, WebSocketProgress progress, AndroidPublishSettings settings = null)
{
var progressWithL10N = progress.WithL10NPrefix("PublishTab.Android.File.Progress.");
using (var dlg = new DialogAdapters.SaveFileDialogAdapter())
{
dlg.DefaultExt = BookCompressor.ExtensionForDeviceBloomBook;
var bloomdFileDescription = LocalizationManager.GetString("PublishTab.Android.bloomdFileFormatLabel", "Bloom Book for Devices", "This is shown in the 'Save' dialog when you save a bloom book in the format that works with the Bloom Reader Android App");
dlg.Filter = $"{bloomdFileDescription}|*{BookCompressor.ExtensionForDeviceBloomBook}";
dlg.FileName = Path.GetFileName(book.FolderPath) + BookCompressor.ExtensionForDeviceBloomBook;
if (!string.IsNullOrWhiteSpace(Settings.Default.BloomDeviceFileExportFolder) &&
Directory.Exists(Settings.Default.BloomDeviceFileExportFolder))
{
dlg.InitialDirectory = Settings.Default.BloomDeviceFileExportFolder;
//(otherwise leave to default save location)
}
dlg.OverwritePrompt = true;
if (DialogResult.OK == dlg.ShowDialog())
{
Settings.Default.BloomDeviceFileExportFolder = Path.GetDirectoryName(dlg.FileName);
PublishToAndroidApi.CheckBookLayout(book, progress);
PublishToAndroidApi.SendBook(book, bookServer, dlg.FileName, null,
progressWithL10N,
(publishedFileName, bookTitle) => progressWithL10N.GetMessageWithParams("Saving", "{0} is a file path", "Saving as {0}", dlg.FileName),
null,
backColor,
settings: settings);
PublishToAndroidApi.ReportAnalytics("file", book);
}
}
}
/// <summary>
/// Attempt to connect to a device
/// </summary>
/// <param name="book"></param>
public void Connect(Book.Book book, Color backColor, AndroidPublishSettings settings = null)
{
try
{
// Calls to this come from JavaScript, not sure they will always be on the UI thread.
// Before I added this, I definitely saw race conditions with more than one thread trying
// to figure out what was connected.
lock (this)
{
PublishToAndroidApi.CheckBookLayout(book, _progress);
if (_connectionHandler != null)
{
// we're in an odd state...should only be able to click the button that calls this
// while stopped.
// Try to really get into the right state in case the user tries again.
_androidDeviceUsbConnection.StopFindingDevice();
return;
}
// Create this while locked...once we have it, can't enter the main logic of this method
// on another thread.
_connectionHandler = new BackgroundWorker();
}
_progress.Message(idSuffix: "LookingForDevice",
comment: "This is a progress message; MTP is an acronym for the system that allows computers to access files on devices.",
message: "Looking for an Android device connected by USB cable and set up for MTP...");
_androidDeviceUsbConnection.OneReadyDeviceFound = HandleFoundAReadyDevice;
_androidDeviceUsbConnection.OneReadyDeviceNotFound = HandleFoundOneNonReadyDevice;
// Don't suppress the first message after (re)starting.
_previousDeviceNotFoundReportType = DeviceNotFoundReportType.Unknown;
_connectionHandler.DoWork += (sender, args) => _androidDeviceUsbConnection.ConnectAndSendToOneDevice(book, backColor, settings);
_connectionHandler.RunWorkerCompleted += (sender, args) =>
{
if (args.Error != null)
{
UsbFailConnect(args.Error);
}
_connectionHandler = null; // now OK to try to connect again.
};
_connectionHandler.RunWorkerAsync();
}
catch (Exception e)
{
UsbFailConnect(e);
}
}
public void Start(Book.Book book, CollectionSettings collectionSettings, Color backColor, AndroidPublishSettings publishSettings = null)
{
if (_wifiAdvertiser != null)
{
Stop();
}
// This listens for a BloomReader to request a book.
// It requires a firewall hole allowing Bloom to receive messages on _portToListen.
// We initialize it before starting the Advertiser to avoid any chance of a race condition
// where a BloomReader manages to request an advertised book before we start the listener.
_wifiListener = new BloomReaderUDPListener();
_wifiListener.NewMessageReceived += (sender, args) =>
{
var json = Encoding.UTF8.GetString(args.Data);
try
{
dynamic settings = JsonConvert.DeserializeObject(json);
// The property names used here must match the ones in BloomReader, doInBackground method of SendMessage,
// a private class of NewBookListenerService.
var androidIpAddress = (string)settings.deviceAddress;
var androidName = (string)settings.deviceName;
// This prevents the device (or other devices) from queuing up requests while we're busy with this one.
// In effect, the Android is only allowed to request a retry after we've given up this try at sending.
// Of course, there are async effects from network latency. But if we do get another request while
// handling this one, we will ignore it, since StartSendBook checks for a transfer in progress.
_wifiAdvertiser.Paused = true;
StartSendBookOverWiFi(book, androidIpAddress, androidName, backColor, publishSettings);
// Returns immediately. But we don't resume advertisements until the async send completes.
}
// If there's something wrong with the JSON (maybe an obsolete or newer version of reader?)
// just ignore the request.
catch (Exception ex) when(ex is JsonReaderException || ex is JsonSerializationException)
{
_progress.Message(idSuffix: "BadBookRequest",
message: "Got a book request we could not process. Possibly the device is running an incompatible version of BloomReader?",
progressKind: ProgressKind.Error);
//this is too technical/hard to translate
_progress.MessageWithoutLocalizing($" Request contains {json}; trying to interpret as JSON we got {ex.Message}", kind: ProgressKind.Error);
}
};
var pathHtmlFile = book.GetPathHtmlFile();
_wifiAdvertiser = new WiFiAdvertiser(_progress)
{
BookTitle = BookStorage.SanitizeNameForFileSystem(book.Title), // must be the exact same name as the file we will send if requested
TitleLanguage = book.BookData.Language1.Iso639Code,
BookVersion = Book.Book.MakeVersionCode(File.ReadAllText(pathHtmlFile), pathHtmlFile)
};
PublishToAndroidApi.CheckBookLayout(book, _progress);
_wifiAdvertiser.Start();
var part1 = LocalizationManager.GetDynamicString(appId: "Bloom", id: "PublishTab.Android.Wifi.Progress.WifiInstructions1",
englishText: "On the Android, run Bloom Reader, open the menu and choose 'Receive Books via WiFi'.");
var part2 = LocalizationManager.GetDynamicString(appId: "Bloom", id: "PublishTab.Android.Wifi.Progress.WifiInstructions2",
englishText: "You can do this on as many devices as you like. Make sure each device is connected to the same network as this computer.");
// can only have one instruction up at a time, so we concatenate these
_progress.MessageWithoutLocalizing(part1 + " " + part2, ProgressKind.Instruction);
}