Release Notes for Latest Versions

Scripture App Builder 5.4

Release date: 6 April 2019

New Features and Improvements:

  • Keyman keyboards are now specified using Keyman package files (.kmp), many of which can be downloaded from the Keyman website, without needing to use Keyman Developer.

  • Additional German translations have been added for the app interface.

Bugs Fixed:

In the Android app:

  • Audio file downloads were not working on Android 9.0 (Pie) because of permissions and internet security issues.
  • Offline MP4 videos were not being displayed properly in the app because of styling issues.

In the app builder:

  • The first time you built a new app, the verse layout and verse number settings were not included for the Settings screen.
  • If verse number markers (v) appeared in the middle of a line which did not begin with a marker, they would not be interpreted correctly as verse markers. The marker code would be displayed in the text.
  • Custom styles could not be deleted.

Scripture App Builder 5.3

Release date: 20 March 2019

New Features and Improvements:

  • Preparations for the release of Scriptoria (the new app publishing service).

Bugs Fixed:

In the Android app:

  • If ‘Allow long press text selection’ is disabled, long press text selection should not be allowed in footnotes, search and annotation screens.

In the app builder:

  • Installing Android SDK packages from Settings did not work if there were spaces in the path.
  • The READ_PHONE_STATE permission should not included when building the app (unless you are using one of the restricted user security modes).
  • The choice of interface languages in Settings > Interface should just be English, French and Spanish.

Scripture App Builder 5.2

Release date: 1 March 2019

New Features and Improvements:

  • Video Improvements
    • Add Video Wizard – click on the ‘Add Videos…’ button on the Videos page.
    • Insert 61 JESUS film video clips into Luke’s Gospel in a language of your choice.
    • Select ‘JESUS film clips’ on the first page of the Add Video Wizard and follow the instructions in the subsequent pages to select country, language and titles.
    • The ‘File Source’ table is now available in the tabs on the Video page (as well as being on the Audio page).
    • When a YouTube video finishes playing, it shows a set of related videos to play next. You can specify that you want these related videos to be from the same channel as the video that has just finished playing. See Video > Video Settings.
  • Book Portions
    • You can now specify which chapters and verses of a book to include in an app.
    • This could be useful if only part of a book has been consultant checked for publication.
    • See the bottom of the Book tab.
  • More translations:
    • Added more Spanish translations to the App Builder interface.
    • Added app translations in Hindi and Telugu.
  • More images:
    • Added more icons, borders, splash screen and navigation drawer images.
  • Updated font:
    • Annapurna SIL version 1.204.
  • Separated out code for security modes requiring access to the device IMEI number into a separate library. The code will only be included in the app if it needs to be.

Bugs Fixed:

In the Android app:

  • Pressing the ‘Back’ button while in the calculator screen caused the app to crash.
  • Using the markdown link format in the About box to link to a Scripture reference caused the app to crash.
  • The Book, Chapter and Verse tab titles in the reference selector were always shown in CAPS. They could not be changed to lower case in the Interface translations.
  • The book selection menu was blank when using Annapurna font version 1.203. Updated font to latest version 1.204, which fixes this issue.
  • Videos were being shown multiple times if the app was restarted from a minimised state.

In the app builder:

  • The internet permission was not set when including links to online videos (#62578).

* If the list of interface languages was reordered, this order was not saved between sessions.

Scripture App Builder 5.1

Release date: 22 January 2019

New Features and Improvements:

  • In-app Keyman keyboards (for beta testing)
    • You can now integrate Keyman keyboards within your app for use on the Search screen.
    • Add one or more keyboards in the builder at Fonts > Keyboards. You will need the compiled keyboard JavaScript file from Keyman Developer.
    • Select a keyboard to use on the book collection > Styles tab.
    • Current limitations: choosing a mix of Keyman and system keyboards will not work well. Add Note screen keyboard not supported yet.
  • Relative font sizes for interface languages
    • For interface languages that need a slightly larger font size, you can specify a relative font size (e.g. 110%).
    • Currently supported: message boxes, progress boxes and Settings screen.
    • Go to the Interface > Languages tab, edit a language and select the Text Size.
  • Documentation
    • Added bookmarks to the PDF documents.

Bugs Fixed:

In the Android app:

  • Message box buttons were not being displayed using the interface language font.
  • With videos links included in the app, selecting a glossary item caused the app to crash.
  • If a video and its thumbnail were not of aspect ratio 16:9, part of the thumbnail image was repeated.
  • Some markdown links, such as empty links, were not handled correctly in the About box.

In the app builder:

  • In standard Russian, the books of John are abbreviated like this: ‘Ин.’, ‘1 Ин.’, ‘2 Ин.’, ‘3 Ин.’ but a reference to John’s Gospel Ин. was never included in any reference links.

Scripture App Builder 5.0

Release date: 8 January 2019

New Features and Improvements:

  • Improved support for embedding videos in the app
    • Added ‘Videos’ page in the App Builder.
    • Online videos: support for streaming MP4 files and video clips hosted on services such as YouTube, Vimeo and JESUS film.
    • Offline videos: MP4 video files can be packaged in the app assets, read from a device folder or downloaded from the internet.
    • Thumbnail images for each video: for page load performance, videos are shown initially using a thumbnail image. The video is loaded, streamed or downloaded when the user taps on the thumbnail.
    • Full screen videos: When playing an embedded video, tapping the full screen button in the video player controls will make the video display in full screen mode.
    • Video placement: you can choose to embed a video before or after a given verse, or on the top or bottom of a page, without adding any code within the Scripture book files themselves.
    • Video Settings: show titles under videos, use full screen width, enable full screen.
  • More images to choose from
    • 30 new icons have been added to the Icon Gallery. See the ‘New App’ wizard and ‘Choose from Icon Gallery…’ on the Images > App Icon for Android page.
    • Border image gallery with 17 images to choose from. Click ‘Choose from Gallery…’ on the Images > Border page.
    • Splash screen image gallery with nine (9) sample images to choose from and adapt freely. Click ‘Choose from Gallery…’ on the Images > Splash Screen for Android page.
    • Navigation Drawer image gallery with nine (9) sample images to choose from and adapt freely. Click ‘Choose from Gallery…’ on the Images > Navigation Drawer page.
  • Improved font handling in message dialogs
    • Message dialogs (such as asking whether or not to download audio) and progress dialogs (such as during file download) have been rewritten to use the chosen interface language font for titles, text, checkboxes and buttons.
    • These new dialogs can use the Crosswalk viewer component to display complex Graphite fonts.
  • Bible Slideshow Videos
    • Added ‘Create Slideshow Videos’ wizard to create Bible videos from templates and audio timing information, with the help of PhotoStage software.
    • Right-click on a book or book collection and select ‘Create Slideshow Videos…’
    • To use this feature, you will need the slideshow templates. Information on how to obtain a set of sample templates can be found on the Resources page of this website, under the heading Slideshow Video Templates.
  • Added user setting ‘Show Glossary words’
    • The app user can choose whether or not to see glossary words underlined in the text and linked to their definitions.
  • Contents menu translations
    • Contents titles and sub-titles can be translated into one or more interface languages, so that the Contents menu is displayed according to the current interface language.
  • Display HTML Files for Books
    • If a book is defined using HTML files, the associated files are displayed in a new ‘HTML Files’ tab, found after the ‘Book Names’ tab.
    • This contains html, JavaScript, style sheets and image files.
  • App interface translations
    • Added Arabic and Azerbaijani translations for the user interface in the app.
  • Android compiler upgrade
    • Upgraded to compile with the latest version of Android, 9.0 (Pie) and the latest Google libraries.
    • The minimum Android version on which the app will run is now Android 4.0 (Ice Cream Sandwich). It will no longer run on the older Android 2.3 (Gingerbread) phones.
    • Now using Gradle compiler version 4.10.3.
    • You will need to update your Android SDK libraries. Go to Tools > Settings > Android SDK and click ‘Install Packages…’
  • FCBH and S3 Analytics
    • Analytics summaries are queued and then sent whenever the device is connected to the internet even if the app is not running or the device has been rebooted.
  • Timing file headers
    • Book, chapter, level and separator information is added at the top of each timing file as it is created.
  • Optimization
    • Reduced the size of configuration information in the app.
  • Additional documentation
    • Fonts: explanation of Crosswalk viewer.
    • Video: new section on including videos, and how to insert them into the text of an app.
    • Borders: how to select an image from the Border gallery.

Bugs Fixed:

In the Android app:

  • When searching for an audio file on the device, display a progress dialog rather than freezing the screen so that the user knows that something is happening.
  • The device back button was not taking the app back to the Contents menu.
  • Settings screens were not handling right-to-left interface languages correctly: the text should be aligned right and check boxes and radio buttons should be on the opposite side.
  • Subtitles were not showing for all pages in landscape picture story books.
  • Go straight to the Audio playback speed dialog when tapping the menu icon on the audio toolbar, rather than showing a single menu item to tap.
  • Allow use of the \fp marker for new paragraphs in footnotes.
  • Scripture reference links with multiple words, such as ‘Apostles Works’ were not matched where there also was an abbreviation ‘Works’ (#60983).
  • Scripture reference links containing books with multiple periods and certain Unicode letters were not matched.
  • If selecting a reference link within a popup where the link should open in the main viewer, any open popups should be closed.
  • No verses were shown in cross reference popups for references with a single verse number (rather than a verse range).

In the app builder:

  • When parsing USX files, the
    tag was not being interpreted correctly, resulting in missing verses in the output.
  • The Share App for iOS help text had an incorrect description (#59069).
  • The documentation for ‘Installing and Building on Mac’ had outdated information on testing with the device on iTunes. This was updated on how to use Xcode.
  • Changes in the app name Translations dialog were not reflected in the app name edit box after closing the dialog.
  • In the About box, the country name, PNG, was being wrongly interpreted as part of an image filename (#60232).
  • The number of audio files in the status bar at the bottom of the Audio Files table did not always show the correct number (#60772).
  • Corrected the link in Settings to the Android SDK Command Line Tools download website.
  • Audio file duration was not calculated correctly for 11kHz MP3 files (#59969).
  • Markdown links were not processed correctly if there was a phrase surrounded by square brackets earlier in the text which was not part of the link (#59722).

Scripture App Builder 4.7

Release date: 12 September 2018

New Features and Improvements:

  • Open Multiple App Projects
    • Allows you to open several previously created app projects from your App Projects folder.
    • See File > Open Multiple Apps…
  • App Project Groups
    • Allows you to group related apps together in the tree view on the left of the App Builder screen.
    • See ‘Project Group’ on the App > Project page, or the ‘Project’ page of the New App wizard.
    • Right-click on a project group folder and select ‘New App…’ to add a new app to that project group.
  • New App wizard improvements
    • Added ‘Default Interface Language’ and ‘Interface Languages’ pages.
  • Zip files of Icon images
    • When adding icons on the Images > App Icon page, you can select a zip file of icon images (e.g. as downloaded from Android Asset Studio) rather than needing to unzip the file and add each of the images separately.
  • Importing Digital Bible Library (DBL) texts
    • Read DBL metadata 2.1, including book names and copyright information.
    • Handle nested elements in USX files.
    • Identify chapter-verse separator used in references.
  • USFM 3.0 support
    • Handle word level attributes in glossary links, e.g. \w angels|lemma=”angel”\w*
  • Allow turning off Full Screen mode on double-tap
    • See Features > Formatting > Go to Full Screen when the user double-taps the text.
  • Original source of book file
    • Right-click on a book row in the books table and select ‘Show Original Source’ to display the path to the original location of the book file (the one that will be used if you select ‘Update from Original Source’).
  • More Color Schemes
    • Added Dark Orange, Chocolate, Asparagus Green, Dark Olive Green, India Green, Pakistan Green.
  • More Interface Translations
    • Added missing app interface translations in Indonesian.

Bugs Fixed:

In the Android app:

  • Search whole words was not finding words preceded by or followed by certain punctuation and spacing characters: quote marks, colon, semi-colon, zero-width space, and zero-width non-breaking space. (#52796, #55748, #56430).
  • Main titles (\mt, \mt2) were not being displayed in the first chapter of a book (#58912).
  • Published chapter character (\cp) was not being handled correctly.
  • Song indexes were not displaying the published chapter character.
  • Legacy USFM marker \st was not styled properly using \mt2 styling.
  • App crashed when there was an empty book, such as an empty glossary book.
  • In audio-text synchronisation highlighting for right-to-left scripts, opening and closing quotation marks were not highlighted with the correct phrases.
  • In the book-chapter-verse selector, if the book names were in a right-to-left script, the list of book names was not fully right-aligned.
  • If Contents item or screen titles included ampersands (&), the contents menu would not be saved or loaded correctly.

In the iOS app:

  • For the iPad, if using ‘Show chapter selector immediately after the user selects a book’, nothing happened after selecting a bok.

In the app builder:

  • If books in different book collections had the same filenames, the app builder would only put one of them into the app and so the wrong text would be displayed.
  • Handle images in About box with spaces in filenames.
  • If you use File > Open… to open an already open project, the builder should select this existing project rather than opening a second instance.
  • Export to HTML included a link to the stylesheet tooltipster-shadow.css which does not exist (#58841).
  • Export to HTML glossary entries would not show in chapters where there were no footnotes or cross-references.

Scripture App Builder 4.6.1

Release date: 15 August 2018

New Features and Improvements:

  • Make History screen optional
    • See Features > History > Enable the History screen.
  • Word documents to SFM
    • Added ‘Export…’ button to the Source page of a book created from a Word document, to export the book as a text file with SFM markers.

Bugs Fixed:

In the Android app:

  • Text was not showing underneath images in picture story books if the page had not been fully loaded.
  • Do not show the chapter selector in the book selector if the book is a song book (which will have its own index page).
  • The user’s choice of downloading audio automatically was not saved if the ‘Audio file download’ setting was not enabled for the Settings screen.

In the app builder:

  • If you enabled Firebase Crashlytics, the app would not build because of a missing library repository.
  • Reworded the check boxes in Features > Navigation > Chapter and Verse Navigation to be clearer.
  • Remove the Viewer tab from app builders in Linux, due to incomplete support of Java FX.
  • A valid JDK path in Linux, java-1.8.0-openjdk-amd64, was being reported as invalid.
  • Book content was not updated when changes were enabled/disabled.
  • Changes were not applied in books with HTML content.

Scripture App Builder 4.6

Release date: 10 August 2018

New Features and Improvements:

  • Book-chapter-verse selector
    • After selecting a book, the book selector can now prompt the app user to select a chapter and verse, instead of the user needing to tap on the chapter selector separately.
    • This is an optional setting, ‘Show chapter selector after selecting book’, which can be enabled/disabled on the Features > Navigation page.
  • Optimised chapter loading
    • Moving between books could be slow in the app, especially with larger books (such as Psalms or hymn books), and when using two-pane or verse-by-verse layouts. This has now been optimised, with the app loading chapter by chapter when needed rather than a whole book at a time.
  • Contents Menu
    • The ‘Contents Items and Screens’ page in the builder has been rewritten to make it more user-friendly.
    • Added Navigation Type setting to the ‘Contents Settings’ tab: you can choose for the app to show either an arrow or a menu (hamburger) button after the user selects from the contents menu.
    • Added Image Width setting to the ‘Contents Settings’ tab (a percentage of the screen width).
    • Added a ‘Viewer’ tab which allows you to visualise how the contents menu will look in the app.
    • Documentation: a new section about adding items and screens to the Contents Menu has been added to the ‘Building Apps’ document.
  • Versification
    • See the ‘Versification’ tab for a book collection.
    • Book collections in the app may have different versification systems. For example, Psalm 3:1 in one collection might correspond to Psalm 3:2 in another. In such cases, you can now import a Paratext versification file (.vrs) so that the app can match verses between collections correctly, e.g. in verse-by-verse layout.
  • App writer progress bar:
    • After you launch a build with ‘Build App’, a progress bar is displayed.
  • Book Viewer
    • There is a new ‘Viewer’ tab which allows you to visualise how each chapter will look in the app after interpreting all the formatting codes and styles.
  • About page
    • There is a new ‘Viewer’ tab which allows you to visualise how the About page will look in the app after interpreting formatting codes and variables.
    • Documentation: a new section describing the About page has been added to the ‘Building Apps’ document. This includes a list of allowable formatting codes, such as how to add images, change styles and fonts.
  • Footer
    • The footer at the bottom of chapters now respects any line breaks you have included in the builder.
  • Custom Styles
    • You can now add custom formatting styles. See Styles > Custom Styles.
    • These will allow you to use custom markers in SFM books for paragraph and character styling.
  • Additional USFM markers recognised, some of which were added in USFM 3.0 (April 2018)
    • \po – Opening of an epistle/letter
    • \cls – Closure of an epistle/letter
    • \qd – Hebrew note
    • \lh – List header
    • \lf – List footer
    • \sd# – Semantic division
    • \usfm – USFM version number
    • \fw – footnote witness list
    • \xta – Target reference(s) extra / added text
  • Firebase integration
    • See the App > Firebase page.
    • You can enable Firebase Messaging for push notifications.
    • You can enable Firebase Crashlytics for crash reporting.
  • Audio download
    • Option of writing .nomedia file to audio download folder
    • Timeout and show error message if waiting more than 10 seconds to connect to audio download server
  • Audio Files table
    • Added File Size column.
    • Added a status bar at the bottom of the table containing the number of files, total size and duration.
  • Translations of app interface
    • Added translations in German.
    • Added more string translations in Russian.
  • Runs on Windows with Java version 10, as well as versions 8 and 9.

  • Fonts: updated to Alkalami version 1.100.

Bugs Fixed:

In the Android app:

  • If there were no timing files for a chapter, pressing the back or forward section buttons on the audio toolbar would not move reliably to the previous/next chapters and between books.
  • If all annotation features were turned off, tapping on a verse would result in a blank toolbar appearing and the verse would be underlined. No toolbar should appear in such a situation and the verse should not be underlined.
  • If the selected text toolbar was shown while the audio toolbar was showing, a double shadow appeared at the top of the toolbar.
  • The user’s choice of ‘Download automatically from now on’ was not being saved (#55444).
  • Picture story books with multiple audio files per page (e.g. Bloom books) were crashing when starting to play audio.
  • App stopped if changing screen orientation when viewing a picture story book with multiple audio files per page.
  • Scrolling of the text could fail on some devices when highlighted phrases were after an embedded image (#55445).
  • If only French was enabled as an interface language, English could be selected in the app if the device was in English. The app should only allow selecting an interface language if it is enabled.
  • Non-breaking spaces (~) were not handled in Contents menu titles and subtitles, meaning that the tilde character appeared.
  • Send FirstRun event in FCBH / S3 Digest Analytics to capture first launch.
  • The number of sessions was not reported correctly in FCBH / S3 Digest Analytics (always reporting 1).
  • Report audio event in FCBH / S3 Digest Analytics even if not FCBH Audio (damId = unknown).
  • Include App Name in FCBH / S3 Digest Analytics.

In the iOS app:

  • Use IPA Version Name in About box when using version-name (#57176).

In the app builder:

  • The app builder program would not start on Windows machines using the Java 10 runtime environment.
  • When reading Scripture books from USX files, the <ref loc=…> elements were not recognised.
  • Handle \iex for introduction explanatory or bridge text, and allow section heading to come before it.
  • On the Audio page, tabs and tables were disappearing off the bottom of the screen.
  • Extract Audio wizard: not selecting audio sections properly when the text contained verse ranges.
  • Convert Audio wizard: remove the sampling frequency option since changing it caused problems, and added -write_xing 0 to the ffmpeg command to ensure file duration is read correctly.
  • Non-breaking hyphens could not be used in verse ranges.
  • Handle non-breaking hyphens inserted in Word documents (using CTRL+SHIFT+HYPHEN on Windows or CMD-SHIFT-HYPHEN on macOS).
  • If a paragraph in a Word document (docx) has a manual first line indent, \p should be used rather than \m.
  • When using initial content in a Word document to set the book name, truncate intelligently at word breaks rather than cutting in the middle of a word.
  • Word documents which had a space at the end of their filename, before the docx extension, could not be imported.
  • Component resizing problems at the bottom of the Features pages.
  • Story page > Picture and Motion tabs: images should be resized according to the available screen height (#58212).
  • If, when attempting to build an app, there was a warning about missing About page information, the builder was not going to the correct page after the warning message.
  • Writes a .log file of the build output to the Output folder (Mac & Linux – due to difficulty in copying the output from the build window on Linux).

Scripture App Builder 4.5

Release date: 16 April 2018

New Features and Improvements:

  • Improved support of Word documents
    • Paragraph and character styles are imported.
    • You can create links to other books and chapters by selecting a word or phrase in the document and adding a hyperlink. The hyperlink format is “MAT.11.28” (Matthew, chapter 11, verse 28), or you can include the book collection code, e.g. “KJV/LUK.15” (Luke 15 in the KJV book collection).
  • Additional app interface translations:
    • Vietnamese
    • Farsi
  • Allow user to opt out of sharing usage data (analytics)
    • See the Analytics page or Features > Settings.
  • New version of Gradle compiler, 4.6.
    • This will require an internet connection when you build your next app.
  • Updated font: Awami Nastaliq 1.100.

  • Ubuntu: Support LTS 18.04 (Bionic Beaver)

  • Aeneas: Updated to version 1.7.3.

Bugs Fixed:

In the Android app:

  • If a Scripture reference popup was shown from a link in another popup (e.g. glossary), the ‘launch reference in main viewer’ button did not behave as expected. The previous popup remained on the screen.
  • Share App was crashing the first time when using newer versions of Android.
  • Corresponding verse ranges were not being handled correctly in the verse-by-verse view.
  • About box: Email and telephone markdown links were not shown.
  • If user changes the interface language in Settings, the app bar title should be updated to use the selected language.
  • Links with verse ranges for single-chapter Bible books, e.g. “Jude 4-13”, were not parsed correctly.
  • Major section reference markers, \mr, should not be parsed as Scripture reference links.
  • Give more space to book collection names in the Layout configuration dialog.
  • Improvements to Security by access code.
  • Optimise moving back to a song book from reading a Scripture book.

In the iOS app:

  • Display the book name in the search index at the right even if there is only one book. (#54357)
  • Display the book list, book grid and book button text with the size specified in the UI Style.
  • Show the book button text with the font specified for the book collection.
  • Reduce the startup time by eliminating some duplicate processing (config and glossary).
  • Leave full screen mode when interacting with content (e.g. adding note). (#55378)

In the app builder:

  • Ken Burns effects (pan and zoom) were not getting saved for a new picture story book.
  • Contents menu: Could not edit those items which did not have an image. Double-clicking on the item did not do anything.
  • Contents menu: “Other” layout was not being displayed properly.
  • Contents menu: When adding a contents item, the default title was not coming from the chosen book collection.
  • Story book: the maximum image height was not being saved if we had not moved the focus outside of the spinner text box.
  • If all apps were removed from the builder, the title bar needed to be updated to remove the last app project name.
  • Extract Audio Wizard: start and end times were not being written correctly.
  • Add/Edit Change: the dialog has been made wider.
  • Changes with “\\t” were replaced by tab characters, instead of allowing SFM table markers such as \td and \tr.
  • Remove USFM optional line break, “//”.
  • Thumbnail images were not being generated correctly for book-specific illustrations, where filenames were the same for different illustrations in different books.
  • Audio Files table: Waiting too long before displaying the timing file during aeneas synchronisation.

Scripture App Builder 4.4

Release date: 15 March 2018

New Features and Improvements:

  • App Analytics
    • Added three more Analytics engines:
      • Firebase Analytics
      • Amplitude Analytics
      • S3 Digest Analytics
    • Please see the Analytics section of the Building Apps manual for more details.
  • Launch Scripture reference in main viewer
    • The Scripture reference popups now display a launch icon. Users can press this to launch the reference in the main window.
    • For example, the user is reading Matthew 1 and taps on the reference link to Luke 3. A popup appears with Luke 3. Tapping on the launch icon will select Luke 3 as the reference in the main viewer.
  • Translations
    • Corrected Spanish translation of the App Builder interface.
    • Added additional Chinese translations for the app.
  • Book-specific footers
    • Footers (displayed at the bottom of each page) can be defined at a book level.
    • Go to the book Features tab, select ‘Use book specific setting’ for Footer, and specify the footer text in the Footer tab which appears.
  • Additional book names for matching Scripture reference links
    • See the ‘More…’ button next to the Book Name field.
  • About box codes for copyright and licensing details
    • Text copyright information for a book collection, C01: %copyright-text:C01%
    • Audio copyright information for a book collection, C01: %copyright-audio:C01%
    • Text license information for a book collection, C01: %license-text:C01%
  • About box code for inserting an image
    • Use the markdown code: !(alt text)[image.png]
  • Audio speed
    • Added 0.7x as one of the selectable speed options.
  • Convert Audio Files
    • Launch the Convert Audio Files wizard from the right-click menu on the Audio Files table.
    • Change bitrate, sampling frequency and number of channels for selected audio files.
    • Includes converting MP3 files to smaller 3GP files.
  • Extract Audio Files
    • Launch the Extract Audio Files wizard from the right-click menu on the Audio Files table.
    • Extract specific verses and verse ranges as separate audio files.
    • Includes splitting an audio file by section headings.
  • Allow setting the Maximum Gradle Heap Size to increase or reduce memory use when building the app.
    • See Settings > Build Settings.
  • Enhancements to the iOS app from previous releases
    • Audio playback speed (4.3)
    • Settings: Playback speed (4.3)
    • Show history (4.3)
    • Setting: Keep screen on (4.3)
    • Honor “Allow long-press selection to copy/share individual words and phrases” setting in Features > Annotations Page

Bugs Fixed:

In the Android app:

  • Fixed crash in two-pane view when moving to an introduction in pane 1 where pane 2 does not have an introduction.
  • Handle exception when changing audio player speed.
  • Remove the last element from glossary entry if it is a section heading.
  • Do not show the chapter selector for the glossary book if there is just one chapter or introduction.
  • Add borders between items on the song list index pages.
  • If reading an OT book, and user changes book collection to one that does not have any OT books, show the first NT book rather than the first book (which might not be a Bible book).
  • Clicking on a Scripture reference link would sometimes crash before the popup was displayed.
  • Scripture references were not parsed properly in some cases where book names contained Unicode characters.
  • The ‘~’ character was showing in the search results.
  • When sharing files on Android 7.0 and above, the app crashed sometimes because of a Uri encoding problem.
  • When using Crosswalk, the universal APK (containing both ARM and x86) was not working reliably on all phones. Creation of the universal APK has been disabled.
  • Incorrect CSS was being generated for Graphite font features and language. Use font-language-override and font-feature-settings.
  • If you rotated the screen when in the Settings screen, and then pressed the Back button, the app would crash.

In the iOS app:

  • Play from the selected verse when tapping the play icon in the selection context menu. (#54318)
  • Make search results consistent with Android implementation including showing the number of results at the bottom of the screen. (#54357)
  • Perform substitutions in About dialog.
  • Do not show the chapter selector for the glossary book if there is just one chapter or introduction.

In the app builder:

  • Changes to the interface language order (by dragging rows) were not saved and not reflected in the Settings screen in the app.
  • The Timing Start column in Audio Files table was showing .00 rather than the actual decimal places.
  • The Browse button was not visible on the Files tab in the Settings dialog.
  • The iOS IPA filename was shown at the start of the batch file when building an Android app, and app version information was repeated.
  • The ‘~’ character was showing in the song index tables.
  • In Changes, the \w character in regular expressions was not matching unicode characters.
  • In Export to HTML, Scripture references were not parsed properly in some cases where book names contained Unicode characters.
  • The app builder toolbar could be detached by double-clicking, and it was not obvious how to get it back in position again.
  • On the Aeneas Phrase Boundaries page, the box for setting a percentage was not completely visible in the dialog.
  • If border images have transparency, show in the image viewer with a white background.
  • Need to check that a valid JDK folder has been entered before trying to install Android SDK packages.
  • Export to HTML: Incorrect CSS was being generated for Graphite font features and language. Use font-language-override and font-feature-settings.
  • Font features were not always encoded properly for XML in the appDef file.
  • Update the tools used to get the list of iOS Simulators available to make it work on macOS High Sierra.

Scripture App Builder 4.3

Release date: 8 February 2018

New Features and Improvements:

  • Audio playback speed
    • Allow the app user to slow down or speed up the audio playback speed.
    • Available speeds: 0.4x, 0.6x, 0.8x, Normal, 1.2x, 1.4x, 1.6x.
    • See the new menu button (three vertical dots) on the right of the audio toolbar.
    • This feature is available only for Android devices running Android version 6.0 (Marshmallow) or higher.
  • History
    • The app keeps a record of which books/chapters you have visited.
    • The history can be viewed by tapping ‘History’ on the navigation drawer menu.
    • Tap on a history item to take you to that reference.
    • Clear the history by pressing the trashcan icon on the app bar.
  • New App Settings (for users of your app to modify)
    • Keep screen on (do not let the device go to sleep when you are using the app).
    • Audio file download setting (Always ask user before downloading, download automatically, or download automatically if using a Wi-Fi connection).
    • Audio playback speed (see above).
  • Changes Gallery
    • Press the ‘Add Change from Gallery…’ button on the app builder Changes page.
    • Select from a set of frequently used changes, such as “Replace / with zero width space”, “Replace << with «”, “Keep 2-letter word with previous word at end of section heading”.
  • Export to HTML
    • Allow links in popups (e.g. footnotes) to be clickable.
  • Optional limits to selecting and copying text
    • Limit the number of verses that can be selected for highlighting/copy/share.
    • Enable/disable the default copy/share text toolbar when long pressing in the text viewer.
    • You can configure these settings on the Features > Annotations page.
  • App interface translations
    • Added missing Spanish and Portuguese translations.
    • Added Hindi and Malayalam.
  • About page verification
    • The app builder will now check that there is text on the About page before allowing you to build the app.
  • Enhancements to the iOS app
    • Notes sharing feature: to allow reviewers in a language community to send feedback on a translation. For this, specify an email address and subject line in the app builder on the Features > Annotations tab. [Note: For iOS, you can only send all notes, bookmarks, or highlights, not individual items with the specified email address and subject. There will be an additional icon in the navigation bar. If the subject is specified, it will be set when sending individual items.]
    • Implemented “Use the current system language of the device…” and “Use this language”.
    • Right-to-Left layout.
    • Song book index page.
    • Added copy icon to the action bar when selecting text.
    • Share App feature (requires Apple ID from iTunes Connect).
    • Handle multiple audio files per page (for Bloom books).
  • Enhancements to Security by Access Code for Android apps
    • Added the option of adding customisable user details (first name, last name, telephone number, etc.) to the ‘Add User’ screen.
    • View users that have been added on the ‘Users’ screen (menu item on the navigation drawer menu).
    • Require administrator to enter a PIN code before accessing ‘Add User’ and ‘Users’ screens.
    • Share button to enable sharing the IMEI number from the welcome screen.
    • Share button to enable sharing the access code after a user is added.
    • Share button to enable sharing a list of added users (see the top of the Users screen).
  • App Builder interface improvements
    • Display the settings in the Features > Settings table according to categories.
    • Allow checking/unchecking checkboxes in tables using the spacebar.
    • Changed the title of the ‘About Box’ page to ‘About’ (since it is no longer a box in the app).

Bugs Fixed:

In the Android app:

  • If you had a contents menu and went into the Settings screen from the contents menu and changed a text display setting (such as turn on/off verse numbers), when you tried to leave the Settings screen you would get an indefinite progress wheel.
  • Handle right-to-left book grid layout in the book selection popup when using the Crosswalk viewer.
  • Audio clips in annotations were crashing.
  • If three book collections were chosen in verse-by-verse layout, and then this was reduced to two, when the app was restarted, three collections were shown.
  • In the chapter/verse selector, make sure we have a chapter number specified, if the user moves to the Verse tab and selects a verse number without selecting a chapter first.
  • If you pressed the Pause button when playing a chapter with synchronized phrases and if you paused near a phrase break, when you restarted the playback the next phrase was sometimes highlighted without clearing the highlighting of the previous phrase.
  • Search was crashing if the user interface language translation of the ‘Search_Number_Found’ string did not contain the %,d formatting code.
  • The USFM non-breaking space character ~ was visible in song indexes if it was used in song titles.
  • Song numbers in the song indexes were being displayed using the default numeral system, even when a different numeral system had been specified for the book or book collection.

In the iOS app:

  • Play audio clips in popups (e.g. when viewing a glossary definition) instead of showing the filename.
  • Display all languages in Interface Languages if there are more than two languages (the table was too short before).
  • Hide play button in action bar if timing information is missing.
  • Do not show empty chapters (#54319).
  • Use localizations of settings headings for when interface language is changed.

In the app builder:

  • Some fonts were missing in the Windows installer.
  • Building iOS apps and running the simulator requires Xcode 9 or greater to be installed. (#53578)
  • If a picture story book was specified in an SFM file, Export to HTML was not displaying the images in the web browser.
  • Stop generating 50×50 iOS AppIcon (warning in build output).
  • Handle quote characters in App Name when building iOS apps.
  • Limit characters that can be in IPA filename (#53662).
  • Require Explicit App ID in Provisioning Profiles when building for Apple App Store.
  • Report error if Wildcard App ID doesn’t match Package Name for non-App Store builds (#53662).

Scripture App Builder 4.2

Release date: 18 December 2017

New Features and Improvements:

  • Graphite font rendering with Crosswalk
    • Apps can include the Crosswalk viewer component and use it instead of the standard Android viewer.
    • Crosswalk is Graphite-enabled, so complex fonts which rely on Graphite rendering features can be displayed correctly.
    • See the Font Handling page in the New App wizard or Fonts > Font Handling > Crosswalk.
    • Apps built with Crosswalk require a minimum Android version of 4.1 and work up to the latest version (Android Oreo 8.1).
    • The following screens in the app can be displayed using Crosswalk: main text viewer, popups for footnotes, glossary and cross references, book selection popup, search entry, search results, annotation lists (bookmarks, highlights, notes), and note popup, about box, settings screen.
    • The following screens are not yet shown with Crosswalk: navigation drawer menu, share app dialog, layout & language dialog, add/edit note. The search entry screen does not yet support input buttons.
  • App interface translations in Turkish.

  • Fonts

    • Updated the following fonts: Annapurna (1.203), Awami Nastaliq (1.000), LateefGR (1.200), Padauk (3.003).
  • Enhancements to the iOS app
    • The user can now change the user interface language (for menus and messages) within the app, via the Settings screen.
  • Styles
    • Allow the search entry text font to be set at a book collection level.

Bugs Fixed:

In the Android app:

  • Improve the handling of book and chapter selector widths on the Android app bar.
  • Do not show the search and text size buttons if there is not enough room for them together with the book and chapter selectors (#52254).
  • The image on the Share App dialog in the Android app was not coloured according to the app bar. It always appeared in grey.
  • Settings: Do not show the Book Selection setting if there is only one book.
  • Settings: Do not show the Show Verse Numbers, Verse Layout, Show Verse Selector settings if there are no verse numbers in the app.
  • Song book indexes crashed if there were fewer than ten songs.

In the iOS app:

  • Settings: Do not show the Book Selection setting if there is only one book.
  • Settings: Do not show the Show Verse Numbers, Verse Layout, Show Verse Selector settings if there are no verse numbers in the app.
  • Highlight the last phrase of a chapter when using point timing files (labels with the same beginning and ending values). (#52049)
  • Display the correct note when tapping on note icon in content view. (#52256)
  • Settings: Use the correct translation for headers (sometimes they were switched). (#52256)
  • Settings: Do not show empty space when no summary description is provided. (#52256)
  • Settings: Do not show “Highlight synchronized phrases” when no timing information is available. (#52256)
  • Settings: Do not truncate long (multi-line) summaries and titles. (#52256)
  • When showing the “Language & Layout” dialog in landscape mode, display toolbar with correct height. (#52256)
  • When a hardware keyboard is attached to an iPhone (happens most with Simulator), allow text to be entered in the Search field. (#52049)
  • When going to a verse from annotations or search, set the audio play position (if timings exist). (#52049)

In the app builder:

  • Word document import problems:
    • Failed to import document that did not have a default paragraph style.
    • Did not transform images that needed to be rotated.
    • If a book was set to ‘Picture Story Book’, it might be set to ‘Default’ when the book is reloaded.
  • Table column widths were not scaled according to the screen resolution.

  • Missing label translation on Book collection Footer page.
  • Refer to book collection ‘short name’ rather than ‘abbreviation’ in app build message.

Scripture App Builder 4.1

Release date: 05 December 2017

New Features and Improvements:

  • Image Viewer
    • Double-click on a row in an image table (illustrations, icons, splash screen) to see a bigger image, which you can resize to see more clearly.
    • The image viewer is also shown by double-clicking on the image in the Contents menu item configuration and in the Story Pages Picture tab.
  • Audio Files table
    • Right-click on the header of the Audio Files table to turn on/off columns.
    • New column: Timing file last modified date/time
    • New column: Start time of the first timing. This can help you identify those timing files which begin at 0.0 when you would have expected them to start a few seconds in.
  • Fine Tune Timings
    • The app builder can now watch for modified timing files saved in your browser Downloads folder and move them automatically to your project data folder.
    • To set the Downloads folder, see Settings > Files.
  • Settings
    • Added new user setting ‘Highlight synchronized phrases’ to allow user to turn on/off the yellow highlighting when the audio is playing.
    • This setting can also be turned on/off in the app builder. See the Audio > Audio Settings page.
    • Set the ‘Layout Direction’ user setting to be disabled by default for new apps.
  • Import of non-Scripture books
    • Support the import of Bloom books and improvements to the import of Word documents.
    • Images loaded from Word documents and html files are now stored in book-specific folders in the project data structure rather than all being copied to the illustrations folder.
  • Interface translations:
    • Added more translations in Indonesian.
  • Export to HTML
    • Improved styling of chapter number selector menu.
  • Book features
    • Allow chapter number position to be set in the book-level features.
  • Update iOS app to Android features
    • Updated Settings dialog (except for user interface language and app layout direction).
    • Added ‘Language & Layout’ in navigation drawer.
    • Added customisable landscape image in navigation drawer.
    • The audio toolbar can be turned on automatically when the app launches.

Bugs Fixed:

In the app:

  • Unable to select and highlight a verse with a verse range, e.g. 2-3.
  • Settings: do not show user interface language option if there is only one language.
  • Settings: do not show ‘Show Border’ option is there is no border.
  • Settings: after leaving the Settings screen, any text display changes, such as turning on/off verse numbers, were not applied immediately to the current chapter.
  • The font of the current interface language was not being applied to the navigation menu, app sharing dialog, layout configuration, annotation list menus or search screen.
  • Audio kept playing after pressing the device back button to exit the app.
  • If the audio was set to be on when the app launches and the audio on/off button was set to be hidden, then if you viewed a book without audio, the audio was turned off and could not be turned on again.
  • Border images were not shown in the correct positions when the app was in a right-to-left layout.
  • Tables not being displayed correctly if a table row was split across two lines in the USFM file with a verse number at the start of the second line.
  • When sharing selected text, the sharing screen title was not translatable.
  • When sharing selected text, the text selection toolbar did not get hidden afterwards.
  • Highlighted or bookmarked verses with the no-break tilde character (~) were displayed without the tilde being replaced by a no-break space.
  • Song numbers in the song list screen were sometimes split over two lines.

In the iOS app:

  • Fix crash on startup when installing on device.
  • Fix crash when including a glossary with no chapters (#52077).
  • Fixed margin around the switch language button in the upper-right corner of the text display (#51779).
  • Allow hiding empty chapters (#52076).

In the app builder:

  • Interface Languages:
    • Language name and font family were not being saved correctly.
    • English translations could not be edited.
    • Set font of editable column according to font of interface language.
  • Thumbnails of images that were short and wide were cropped in the first column of the image tables.

  • Missing interface string translation on the Phrases page of the aeneas synchronisation wizard.
  • Interface language names were written repeatedly in the .appDef project configuration file.
  • During synchronization with aeneas, the Audio Files table was not adding new timing files as they were created.
  • Add iOS images sizes to Navigation Drawer images.

Scripture App Builder 4.0

Release date: 21 November 2017

New Features and Improvements:

  • Navigation Drawer
    • The app bar menu has been replaced by a navigation drawer which slides in from the side of the screen.
    • To show the drawer, swipe in from the side of the screen or tap the hamburger icon (the three horizontal lines on the app bar)
    • At the top of the drawer is an image which you can customise in the app builder. See Images > Navigation Drawer. (For Android only at this point, the iOS app shows the app icon.)
  • Text Selection Toolbar
    • If you tap a verse in the app, it will be selected (underlined) and the text selection toolbar will appear at the bottom of the screen. From this toolbar you can choose to highlight the selected text, add a note, place a bookmark, play audio beginning at this verse, copy the text to the clipboard or share it.
  • Highlighting
    • Select the highlighter pen button from the text selection toolbar.
    • There is a choice of several highlighter pen colours: yellow, green, orange, blue and pink.
    • You can remove a highlight by selecting the white pen colour.
    • View a list of highlighted verses by selecting Highlights from the navigation drawer menu. On this screen you can sort highlights by date, reference or colour (tap on the Sort button on the app bar). You can delete highlights or tap an item to go to the highlighted verse. You can also share the list of highlighted verses with someone else (tap on the Share button on the app bar).
  • Notes
    • Select the Note button from the text selection toolbar. You can add personal reflections, teaching notes, feedback on the translation, etc.
    • The Add Note screen will appear. Special characters can appear as buttons, like on the Search screen.
    • A note icon will be displayed at the end of the verse. Tap on this icon to see the note in a popup window at the bottom of the screen. Tap on the edit icon to enter the Edit Note screen.
    • View a list of notes by selecting Notes from the navigation drawer menu. On this screen you can sort notes by date or reference (tap on the Sort button on the app bar). You can edit or delete notes or tap on an item to go to the verse with the note. You can also share the list of notes with someone else (tap on the Share button on the app bar).
    • You can use the notes sharing feature to allow reviewers in the language community to send feedback on a translation. For this, specify an email address and subject line in the app builder on the Features > Annotations tab.
  • Bookmarks
    • Select the bookmark button from the text selection toolbar.
    • A red bookmark icon will be displayed at the end of the selected verse.
    • To remove the bookmark, tap on the bookmark icon at the end of the verse and then tap on the bookmark button.
    • View a list of bookmarks by selecting Bookmarks from the navigation drawer menu. On this screen you can sort bookmarks by date or reference (tap on the Sort button on the app bar). You can delete bookmarks or tap on an item to go to the verse with the bookmark. You can also share the list of bookmarked verses with someone else (tap on the Share button on the app bar).
  • Text Copy and Share
    • To copy a verse to the device clipboard, tap on the verse to select it. Then select the Copy button from the text selection toolbar. (Android only)
    • To share a verse with someone else, tap on verse to select it. Then select the Share button from the text selection toolbar. You can choose to share by text message, email, WhatsApp, etc. For iOS apps, the menu that allows you to select an app also contains a “Copy” icon that will copy the verse to the device clipboard.
    • You can include an extra line of text after the copied verse and reference, e.g. copyright information or details of how to get the app. See Book Collection > Copyright & Licensing.
  • Changing the app Interface language (Android app only)
    • The user can now change the language of menus and messages within the app, via the Settings screen.
    • To define which interface languages the user can choose from, see the new Interface > Languages tab in the app builder. You can add additional languages here and enable/disable existing languages.
    • You can choose to set the default language to be the current language of the smartphone or tablet.
  • Right-to-Left layout (Android app only)
    • The whole app layout can be switched around so that the navigation drawer slides in from the right of the screen, the contents of the app bar are displayed in the reverse order (i.e. book name on the right), and audio controls are displayed with a right-to-left play button and seek bar moving from right to left.
    • Set the default layout direction in the app builder on the Interface > Layout Direction tab.
    • Users can change the layout direction within the app, via the Settings screen.
  • Settings within app
    • The Android app Settings screen has been rewritten and rearranged into categories.
  • Audio settings
    • Audio features in the app builder have been moved to the Audio > Audio Settings tab.
    • Two new features have been added:
      • Choose whether to allow the user to turn on/off the audio toolbar.
      • Choose to show the audio toolbar when the app is launched.
  • Default package name
    • You can set the default start of the package name for building new apps. See Settings > Defaults.
  • Copyright & Licensing
    • Copyright and Licensing information for text, audio and illustrations are now saved and displayed on the new Copyright & Licensing tab for each book collection.
  • Other Android app design changes
    • Book and chapter selector images have been changed to dropdown arrows to the right of the book name or chapter number on the app bar.
    • The About box is now a full screen page rather than a popup window.
  • Compling for Android 8.0 Oreo
    • Android apps are now compiled using the Android SDK platform library for the latest version of Android (version 8.0 Oreo).
    • You will need to update your Android SDK installation. The Android 5.0/5.1 platform has been used up until now and can no longer be used for SAB 4.0+.
  • Documentation updates
    • Most of the documents have been updated with new information for SAB 4.0.
  • Other iOS app improvements
    • Swiping between books is now supported as an optional feature as it has been in the Android app.
    • The option to display a verse selection tab after selecting a chapter is now supported as an optional feature.
    • If no timing files are associated with audio for the chapter being played, an audio seek slide control is displayed as it is in the Android app.
    • Picture storybook features are mostly completed.

Bugs Fixed:

In the app:

  • The app was not synchronising chapters correctly in two-pane layout when one of the texts had empty chapters.
  • A chapter containing only period characters (.) should be considered empty.
  • Right-to-Left cross references (using the \r marker) were not linked correctly in the text display.
  • Verse numbers such as 2a or 3b were not processed correctly when reading USX book files.
  • Footnote custom callers with more than one character were not handled correctly when reading USX files.
  • On list selection popups from the Settings page, the Cancel button was not translated into the app interface language.
  • Allow changing the font of Chapter/Verse selector tabs, using the style “ui.selector.tabs”.
  • Changed book collection “Abbreviation” to “Short Name” to encourage users to use something longer than a language code which could be hard to see and tap on the screen.
  • If formatting codes were used, such as italics (\it…\it*), audio highlighting of these sections was out of sync if a space was found just before the closing formatting code.
  • If a page has no audio, the audio toolbar should be hidden.
  • If the user is playing audio for a chapter and then selects the current chapter number from the chapter selector and restarts audio, two audio tracks were played (#51922).
  • If a timing file had been written using the Fine Tune Timings utility, the first timing might not be read correctly in the app due to a BOM (byte-order mark) at the start of the file (#51650).
  • FCBH Analytics retries sending data if attempts initially failed.

In the iOS app:

  • Allow pinch zoom on image annotations.
  • Adjust the size of the section header in the Search Results display. Occasionally, part of the characters in the header were being cut off.
  • Do not highlight first timing section if audio is turned off.

In the app builder:

  • In the New App Icon wizard page or the Icon Gallery dialog, the user should only be able to choose one icon, not multiple icons.
  • The OK button was not working in the Devices dialog box.
  • The Run iOS Simulator dialog works with Xcode 9 and can build for just the simulator. (Mac only)
  • The Create New KeyStore feature uses new default key algorithm (RSA) and size (2048) to work with jar signing in JDK 1.8 u151+.

Scripture App Builder 3.5

Release date: 13 July 2017

New Features and Improvements:

  • Verse selector:
    • After selecting a chapter number, a verse number selection page will slide into view.
    • This can be turned on/off in the app builder and also via an optional user setting within the app.
  • Song book indexes:
    • A new Song List index page is available for song books, displaying songs by number and by title.
    • To enable this, set the Book Type of a book to be “Song Book”.
  • Enhanced Styles configuration:
    • Styles can now be configured at a book collection level and also at the level of individual books.
    • See the Styles tab for each book collection and each book.
  • Language tag in HTML output:
    • You can specify a language code to be used in the HTML output as a tag, e.g. lang=”xyz”.
    • See the Styles tab for each book collections or book.
  • Spanish Interface
    • Additions and corrections to the app builder user interface in Spanish.
  • iOS app enhancements:
    • Added media clip annotations.
    • Added locking the orientation for books to portrait or landscape.
    • Added Ken Burns effects in Picture Story books
    • Added Subtitles in landscape orientation
    • Allow pinch zoom of image annotations
    • Added support for SAB Layout Defaults Tab
    • Added support for two pane layout with panes not linked
  • Paratext markers:
    • Added \pi1.
  • Analytics:
    • Added FCBH Analytics which sends a small digest package of anonymous app usage information to Faith Comes By Hearing. FCBH will provide a service to collect and display in an Analytics dashboard.
  • Crosswalk viewer component:
    • If the standard Android viewer component is not displaying your complex script correctly, there is now the option of bundling the replacement Crosswalk viewer with your app.
    • Note that this will mean an increase in app size of at least 20 MB, so do not enable Crosswalk unless you know you need it.
    • Three APK fies will be created: one for ARM devices (-arm.apk), one for Intel x86 devices (-x86.apk), and a universal APK for both (-universal.apk).
  • Fonts
    • Added Alkalami font, for Arabic-based writing systems in the Kano region of Nigeria and in Niger.

Bugs Fixed:

In the app:

  • Border images around the text were not being scaled properly according to screen resolution.
  • Audio synchronization was getting behind a phrase each time a document contained a picture with no other text in the paragraph.
  • Not processing Scripture reference links properly where a comma was used as a chapter list separator, e.g. Matthew 3:4, 5:6.
  • App sharing text was not translatable (“I can recommend this app”, “Share App via”, etc.)
  • If an SFM table had three columns, for example, and there was no space following a blank \tc3 then SAB did not handle \tc3 as an empty cell.
  • Failed when trying to write analytics event when no chapter was selected.

In the iOS app:

  • Fixed app crash caused by font not being defined in app definition and in some cases where
    specified font could not be loaded.
  • Don’t display settings button in app if all settings are deselected in app definition
  • Scale borders around text area to match Android app border sizes
  • Set font for navigation bar menu items and text fields in settings screens
  • Certain sequences could result in the app attempting to download the audio for a chapter when it had already been downloaded.
  • If the user clicked on a URL link placed within the footer text, the web page would be displayed within the Scripture app. Attempts to download a file could crash the app. Now clicking the link will start the default browser.
  • Most of the popover menus did not display properly when run on an iPhone Plus model in landscape mode.
  • If the same name is used for audio files in different sources, only the first was recognized. Now use both the source id and the audio name to identify the downloaded file name.
  • Moved Text Size button to be under the “hamburger” menu when in iPhone portrait mode to prevent the “hamburger” menu button from being pushed off screen when the book name was very long.
  • App crashed if you played audio, went to book with no audio, went to full screen and pressed the “play” button which erroneously appeared at the bottom of the screen.
  • App crashed if multiple book collections were defined, one of which had audio, and an attempt was made to play the audio while another book collection was the current selection.

In the app builder:

  • Translations to app names not being saved between app builder sessions.
  • Not handling the deletion of book files properly or restoring book files that were deleted but not saved.
  • Failed to generate HTML when creating glossary entries in Export to HTML.
  • Minimum Build Tools version should now be increased to 25.0.0.
  • Android builds failed if the package name contained certain Windows reserved directory names in the package name (e.g. con, aux, nul).
  • Validate Font at the book collection level was not checking against correct font if the book collection font was different from the first font defined in the app.

Scripture App Builder 3.4

Release date: 10 May 2017

New Features and Improvements:

  • Multiple book collections in iOS app:
    • Supports single pane view, two pane view, and verse by verse view of up to three translations in a single pane.
  • Android SDK installation changes:
    • The SDK Manager GUI is no longer distributed with the SDK command line tools. There is instead a command line installer, which is launched from the new Tools > Settings > Android SDK tab.
    • Updated installation documentation.
  • Audio Synchronization:
    • Audio phrase ending characters can be defined per book and book collection, rather than just at the app level.
    • See the Audio Synchronization tab.
  • Styles:
    • Added missing paragraph styles for \ipi and \ib.
  • Book order:
    • Added choice of book order when adding a book collection.
    • Can change the book order of a book collection on the Features page.
  • iOS Provisioning Profile and Signing:
    • The Signing (iOS) tab has been enhanced to provide information about the type, app id and team id associated with the selected provisioning profile.
    • Validation: Attempting to build an iOS app, SAB now performs a check to ensure that the Provisioning Profile and Signing Identity that have been selected may be used together and displays an error if not.
  • Updated Gradle Build compiler to version 3 to optimise building apps.

Bugs Fixed:

In the app:

  • Border images not resizing properly in two-pane view.
  • Image-only pages in picture books were showing as empty.
  • Numbers in the chapter selector should be displayed right-to-left for RTL book collections.
  • Not parsing “Revelation given to John” correctly as a book name in Scripture reference links. It was recognised as referring to “John”.
  • Crashed when playing back audio if audio seek bar container was not found.
  • Footer was showing twice in the introduction chapter.
  • Introduction character being shown as 0 in some situations.

In the app builder:

  • Word document import: digits in Word character styles caused problems.
  • For iOS, display an error message early in the build process if fastlane has not been installed properly.
  • Enable the DELETE key when running SAB on a Mac.
  • Updated default aeneas folder in SAB for Mac.
  • If there is more than one font family, show Custom as selected on the Fonts page rather than a known font.

Scripture App Builder 3.3.2

Release date: 27 March 2017

Bugs Fixed:

  • In the Add Contents Menu Item wizard, the Next button would not allow you to advance in some situations.
  • In the ‘Installing and Building on Mac’ document, the XCode tools install instruction contained an n-dash rather than two hyphens.

Scripture App Builder 3.3.1

Release date: 15 March 2017

Bugs Fixed:

  • Could not change choice of book collections in the app layout configuration dialog.

Scripture App Builder 3.3

Release date: 8 March 2017

New Features and Improvements:

  • Scripture App Builder for Mac:
  • Analytics:
    • Support for sending analytics data to Amazon Mobile Analytics (book views, audio files played, apps shared).
    • Allow multiple Analytics engines in the same app to allow sending analytics data to more than one account.
    • See the Analytics page for the app.
  • Contents:
    • You can choose to show the contents screen every time you launch the app or to go to the previously selected screen. See Contents > Contents Settings.
    • You can specify the target layout for contents items in multiple book collection apps.
  • Multiple Book Collections:
    • Save book collections in separate data folders so that book filenames can be repeated across different collections.
  • Styles:
    • Added a CSS tab to the Styles edit dialog to allow adding/editing CSS properties directly.
  • App Install Location:
    • Now configurable. See the App > APK tab.
  • Numeral Systems:
    • Added N’ko numeral system.
  • Footers:
    • Footer styles can be set per book collection and the text direction of the footer can be set to be different from the direction of the main body text.
    • Allow line breaks <br/> in footers.
    • Allow horizontal lines <hr/> in footers.
  • Security:
    • Improvements to styling of screens used by the restricted access by code security mode.
  • Fonts:
    • Annapurna version 1.202 release.

Bugs Fixed:

In the app:

  • Book selection grid of abbreviations not showing right-to-left for RTL scripts.
  • Search special character buttons not showing right-to-left for RTL scripts.

In the app builder:

  • Parameters for aeneas tasks were not being written out correctly if system locale was French.
  • Could not use aeneas to synchronise audio for an introductrion chapter (chapter number 0).
  • Book name, abbreviation, character inventory and source preview not showing in correct font for multiple book collections if the book collection uses a font other than ‘font1’.
  • Book name and filename fields were too short for long filenames and book names.
  • Build path was often too long if the package name was long. Use a shorter path.
  • Image file dimensions not shown on Audio-Only book image page in Add Books wizard.
  • Style edit dialog should allow editing of all the currently defined properties.
  • Problems processing book files in EPUB format.
  • Do not try and show an EPUB file in the book Source preview tab.
  • Timing validation report, e.g. “Files with validation warnings” was not translatable into the current interface language.
  • Export to HTML not showing audio player for second and subsequent pages for picture story book with single audio file.
  • Text direction and numeral system combo boxes were not translatable.
  • Corrected French spelling of ‘Abréviation’.
  • Missing French translations on the Audio Source tab.
  • If the About box font has been changed to a different font from the first font, make sure that the edit field is updated to use this font.

Scripture App Builder 3.2

Release date: 24 January 2017

New Features and Improvements:

  • Build Multiple Apps:
    • New ‘Build Multiple Apps…’ added to toolbar.
    • Choose which apps you want to build and they will be queued and compiled one after the another.
  • Allow setting the maximum height of images for picture story books.
    • Prevents portrait images from taking up all of the screen, leaving no room for text.
    • See Book > Story Pages > Other Settings. Default is 45% of the screen height.
  • Updating books without needing to delete them and add them again:
    • Allow adding a new version of a book on the Book Collections screen to replace an existing book.
  • Audio-Only Books:
    • Use new Add Books Wizard to add Audio-Only books for Old/New Testament without needing skeleton Paratext files.
    • You can choose the album art to show in the app when playing the audio.
    • See Book Collection > Add Using Wizard…
  • Two pane layout:
    • Allow different default font sizes for book collections (see Styles tab), allowing Arabic script collections to use a larger font size than Roman script book collections.
    • If a corresponding chapter is not available in the adjacent pane, show pane as blank rather than showing the chapter of the first book.
  • Audio seek bar:
    • Add an optional audio seek bar under the play/forward buttons
    • This is useful if there is no timing information for a chapter.
  • Avoid the need for the “Read Phone State” permission:
    • The app used to need this permission in order to pause audio when a phone call came in.
    • This is now handled in a different way to avoid needing this permission.
  • USFM markers:
    • Added support for \qac…\qac* – acrostic letters within poetry lines.
  • Documentation:
    • Updated Installation Instructions for installing the basic command line Android SDK tools.
    • Added a comment next to the Android Asset Studio link that it works better with the Chrome browser.
  • Fonts:
    • Updated regional font subsets with inclusion of Graphite support.

Bugs Fixed:

In the app:

  • Drop caps not being formatted properly for poetry books such as Psalms.
  • Cross references (\x + \xt John 1:1\x*) opened a popup but the Scripture references in the popup were not active links.
  • In Scripture references which include a comma to extend the reference range, the extended range is not active e.g. in \xt John 1:2,10\xt* – verse 10 is not active.
  • Glossary links in glossary entry popups were not linked correctly. Instead some numbers were showing.
  • Switching between multiple book collections did not work properly if the abbreviation of a book collection was blank.
  • Audio toolbar disappeared when changing device orientation in two-pane view.
  • After changing orientation when playing audio in 2-pane view, the second pane was not scrolled alongside pane 1.
  • When downloading audio files from the internet: if the download was completed quickly, the progress bar would not reach 100% and the user would not know whether it succeeded or not.
  • If ‘Search all folders for audio’ is not enabled, do not try to look in sub-folders of the named folder for files.
  • Layout configuration dialog: on the Verse-by-Verse tab, if user selects a book collection already showing in a different position, need to swap the other choice.
  • Font not showing correctly in verse-by-verse view if the first book collection was shown in second place.

In the app builder:

  • Require Android SDK Build-tools of version 23 or later. Otherwise inform the user that they need to upgrade.
  • In multiple language apps, custom translation strings for book groups were lost.
  • Unwanted blank line appeared at the top of pages imported from Word documents (from page 2 onwards).
  • For multiple book collection apps, check that first book collection has a name other than the default ‘Main Collection’.

Scripture App Builder 3.1

Release date: 12 December 2016

New Features and Improvements:

  • Translated Strings within the app
    • Added Import/Export, to allow you to share menu item translations between apps.
    • Added ‘Reset Translations’ to the popup menu in the Translated Strings table to allow reset to defaults.
    • More default translations for Spanish and Portuguese.
  • Import/export book collections
    • Allows you to save a book collection and reuse it in another app.
    • This is useful if you want to add a regional language book collection to several of your local language apps.
  • Export to HTML
    • Show cross reference links and pop-ups.
    • Show glossary links and pop-ups.
  • Regular Expression Changes
    • Added enabled on/off checkbox for each change, to make it easier to test changes.
  • Font updates
    • Padauk version 3.002.

Bugs Fixed:

In the app:

  • If the two pane separator was dragged too far down or right, it could not be pulled back again.
  • Verse ranges were not being written correctly for right-to-left scripts: missing RTL marker before the hyphen.
  • Handle double spaces in verse markers, e.g. \v__1 rather than \v_1.
  • App bar not formatted with color, arrow and title for Settings screen on Gingerbread phones.
  • App bar title and arrow disappeared when changing device orientation in Settings screen.
  • Book Group titles in book selection popup were not right-aligned for right-to-left scripts.

In the app builder:

  • Warnings showing in the build if Google Analytics is turned on.
  • If the same audio file was used in two different book collections (e.g. for two different scripts) it was added twice to the app.

Scripture App Builder 3.0

Release date: 29 November 2016

New Features and Improvements:

  • Multiple book collections
    • Add two or more translations to the app.
    • Display in Single Pane, Two Pane or Verse-By-Verse layout.
    • User can configure the choice of translation and layout within the app.
    • Scripture reference and numeral system settings are now at the book collection level.
    • For more details, please see the section ‘Multiple Translations’ in the Building Apps document.
  • Settings screen
    • Allow the user of the app to configure the following settings:
      • Book selection type: list or grid
      • Red Letters: show the words of Jesus in red
      • Show Verse numbers
      • Verse layout: Verses in paragraphs or One verse per line.
  • Share App
    • Added optional ‘Share App’ item in the app menu.
    • Gives the app user the choice of:
      1. Sharing a link to the app on Google Play, or
      2. Sending the APK file to another phone via Bluetooth, Wifi transfer, email, etc.
    • See Features > Sharing to turn on this app sharing feature.
  • Drop chapter numbers
    • Chapter numbers are now displayed by default as drop cap numbers just before the first verse.
    • See Features > Formatting.
  • Audio file searching
    • Previously, the app would search all accessible folders on your device to find an audio file if it was not found in the specified default folder.
    • You can now turn off this feature on the Features > Audio page.
  • Reset colors
    • Added ‘Reset Color’ option to right-click menu to reset color to its default setting.
  • Regular Expression Changes – Show After Changes:
    • Added a ‘Show After Changes’ checkbox to the Book Source page, to allow viewing of what the source will look like after applying any regular expression changes.
    • This is shown only if you have specified some changes on the Changes page.
  • Icons
    • Added ‘Choose from Icon Gallery’ button on Images > Android Icon tab.
    • Allow selection of multiple images when adding custom icon images.
  • Image sorting
    • Sort images in size order when adding app icons.
    • Click on headers in image table to sort rows.
  • Export to HTML improvements
    • Style the Book and Chapter titles as buttons so it is clear they can be clicked to get the dropdown menu.
    • Added viewport meta tag for better responsive design.
  • Contents Menu
    • Keep track of the font size for the Contents Menu as different from the font size of the main text.
    • Prevent contents menu text flowing underneath the image.
  • Fonts
    • Updated Padauk to version 3.001.
    • Updated Annapurna to version 1.201.
  • Gradle compiler – updated to version 2.14.1
    • Note: the first time you build an app, Gradle will need internet access to download an update of the Gradle Android plugin
  • Documentation
    • Building Apps: added sections on Multiple Translations and Sharing Apps.
    • App Publishing Checklist: added final approval item.
    • New French version of the App Publishing Checklist.

Bugs Fixed:

In the app:

  • Pressing the >> audio button before playing the audio for a chapter causes app to crash.
  • Images specified in the text as .tif files were not shown even if a corresponding .jpg file was present.
  • Introduction paragraphs within chapters were displayed at the start of the book rather than in their place.
  • Duplicate items were showing in Contents menu.
  • Chapter selector not displaying right-to-left for Arabic numeral system.
  • Do not show the audio toolbar for landscape picture story books if there is no audio for the book.

In the app builder:

  • Do not include text enclosed by \rq…\rq* markers in phrase lists for aeneas synchronization.
  • Add borders to tables (Audio, Styles, Contents Menu items, etc.)
  • Ensure selection background color is consistent across tables.
  • Turn off column re-ordering for some tables.
  • \ord…\ord*, \dc…\dc*, \sls…\sls* and \rq…\rq* missing from span styles.
  • Verse numbers superscript set in CSS rather than using to allow style changes.
  • HTML export audio playback was starting at the first verse and skipping the heading.
  • Do not show Menu_Access_Code on Strings page if security mode is not set to Code Required.
  • Could not change a document interpreted as a Picture Story book back to Default book type.

Scripture App Builder 2.1.1

Release date: 1 September 2016

Bugs Fixed:

  • Picture story books crashed in the app if the user pressed the >> button before playing audio.
  • When renaming an app project, the app publishing repository folder (git) was not copied.

Scripture App Builder 2.1

Release date: 31 August 2016

New Features and Improvements:

  • Scripture App Publishing Service
    • Enables automated publishing of apps to Google Play.
    • See the ‘Publishing’ page for each app.
    • Pages for defining title, short/full descriptions, screenshots, hi-res icon, etc. for Google Play store details.
    • For more details and answers to frequently asked questions, please see Scripture App Publishing Service.
  • Fine Tune Timings improvements:
    • Added additional ++ and – – buttons to allow moving timings forward/back 1 second as well as 0.1 seconds.
    • Added tooltips to +/- buttons and made buttons the same size.
  • Contents Menu improvements in app builder:
    • New wizard for Add Contents Item.
    • Gets default title and image from book reference.
    • Allows selection of image from picture story book images.
  • Book selection:
    • Can disable book selection popup, e.g. for those cases where you just want users to navigate using the contents menu.
    • See Features > Navigation tab.

Bugs Fixed:

In the app:

  • Problems displaying introduction-only books (i.e. those without any chapters).
  • Links to glossary items in glossary book were not shown first time if the item definitions (\k) were lower in the book than the link (\w).
  • When swiping between books was disabled, audio files were not selected properly for a book when coming from contents menu.
  • Stop audio playing when user moves back to Contents menu screen.
  • Do not show Audio icon while in Contents menu screen.
  • Do not show audio toolbar for books without audio.

In the app builder:

  • Add image motion in a picture story book, then select No motion. Motion was still present when building or re-opening app.
  • 72×72 image missing for icon with green cross.
  • Audio files and timing files were not being assigned to a single line when ‘single file’ is shown as default in the Book > Audio tab for a picture story book.

Scripture App Builder 2.0

Release date: 24 August 2016

New Features and Improvements:

  • Installing aeneas for audio-text synchronization
    • New all-in-one aeneas installer for Windows, replacing the complex manual install of each component.
    • Available on the Download page, under Audio Synchronization Tools.
    • Includes significant speed improvements for Windows users, cutting the synchronization time by up to 50%.
    • Added install check. See Tools > Check aeneas installation…
  • Improvements to Picture Story books:
    • New ‘Story Pages’ configuration tab in the App Builder for each book.
    • Turn on audio toolbar automatically when viewing story books.
    • When viewing the story book in landscape orientation:
      • The pictures are shown full screen and fade to the next one when the page turns.
      • A transparent audio progress bar is shown, which slides off the screen after
        a couple of seconds of playback, and slides back in when the user taps the screen.
      • Subtitles are shown over the pictures.
    • Optional Ken Burns effects (pan and zoom) to move the pictures as the audio is playing
      • Go to the new ‘Story Pages’ tab for a picture story book and choose
        ‘Specify start and end positions’ to modify start and end rectangles visually.
      • Additional SFM codes:
        • \imgms left top width height – for the start rectangle
        • \imgme left top width height – for the end rectangle
    • Include optional background music, including fading out the music at the end of the story book.
    • Choose either one audio file for the whole story book or one file per page.
      • If using multiple audio files, all are downloaded at start of book rather than one at a time.
  • Handling of verse segments, e.g. \v 1-2a, \v 2b, \v 5-6a, \v 6b-7
    • Formats verse numbers correctly.
    • Handles verse segments in timing files.
  • Illustration resizing
    • Resizes images to contain in app to reduce app size.
    • See the Images > Illustrations page.
  • Lock screen orientation
    • You can lock the screen orientation to Portrait or Landscape for a book.
    • See the Book > Features tab.
  • Audio clips
    • You can insert short audio clips to be played when the user taps on a word, phrase or image.
    • To add clips in Word documents, insert a hyperlink with the filename of the audio file.
    • See section 5.5 in the Building Apps manual for more details.
  • Added link styles and removed generic \hyperlink style:
    • a.web-link – allows styling of web links
    • a.audio-link – allows styling of audio clip links
  • Word document import improvements:
    • Handle rotated images.
    • Read footnotes from Word (.docx) document.
  • Offline mode:
    • Attempt to use Gradle in offline mode if there is no internet connection, even if user has not selected offline mode in Settings.
  • Contents menu
  • Fonts:
    • Padauk font updated to version 3.0
  • Scripture references:
    • Read the chapter-verse separator from the Paratext project settings file (.ssf) if it exists.
    • Handle Scripture reference links in table cells.
  • EPUB improvements:
    • Include illustrations in EPUB documents.
    • Added web links to EPUB page for Readium and Gitden Reader.
  • New documentation:
    • App Publishing Checklist: Is your app ready to publish?
    • Running Workshops: Tips for running App Builder training workshops
  • Updated documentation:
    • Installation Instructions: added a section on copying Android SDK files from another computer
    • Building Apps: new sections on ‘Preparing app content’, audio clips and picture story book enhancements.
    • Distributing Apps: more information on Google Play store details.
    • Using aeneas: new installation instructions for Windows users.
    • Using HearThis: updated web links.

Bugs Fixed:

In the app:

  • Problems with getting audio for the next chapter if the screen orientation had changed after the current audio was started.
  • Problem displaying two books with the same book id.
  • Do not show Up navigation button on Search screen.

In the app builder:

  • When reading Word documents with images, SAB did not take into account image rotation.
  • Changes to default translation strings for existing languages were not being saved.
  • The label Features_Chapters_And_Verses_Info was not translated on the Features page.
  • Corrected web link to Android SDK tools to go to the downloads section of the page.
  • In Fine Tune Timings, make sure that the next timing is always after the current timing.
  • Text was truncated on some screens when using 150% text size.
  • Need to check for sufficient image sizes for Android icon when building app.
  • Explanatory text on Android Icon definition page needed to be clearer about which images sizes are required.
  • Build warnings on command line build were using a special character for bullet point.
  • Problem exporting to HTML two books with the same book id.
  • Icon image paths written in Windows not read correctly on Linux machines.

Scripture App Builder 1.11.1

Release date: 01 June 2016

New Features and Improvements:

  • Audio features: added option ‘At the end of a book, go to the next book and continue playing audio’.

Bugs Fixed:

In the app:

  • Playing audio from a picture story book page sometimes caused the page to move to the previous one for a moment before moving to the current one.
  • If playing audio for a second book when ‘swipe between books’ is enabled, the audio for the first book was played again.

In the app builder:

  • Corrections to USX file import:
    • Book names were not read correctly if there was a <para style=”ide”> element.
    • Footnote elements were not read correctly if the attributes were in a different order than expected.

Scripture App Builder 1.11

Release date: 23 May 2016

New Features and Improvements:

  • Borders: improve performance when drawing borders around the text

  • Picture story book import from Word (docx) documents: delete blank lines between images and text.

  • Basic import of HTML files for books

  • Fine Tune Timings: allow audio files to be found in relative paths, useful for sharing the Fine Tuning tasks with others to view on their computers.

  • Export Subtitle files from timing files:

Bugs Fixed:

In the app:

  • Error on choosing not to include a border around introduction pages.

In the app builder:

  • Failed to find certain colors for a color scheme if the color scheme name was blank.
  • Book Source tab: not displaying picture story books page by page; change ‘Chapter’ to ‘Page’; remove initial blank line.
  • Fixes to HTML export for picture story books:
    • Include images in HTML export.
    • Specify start and end audio times for each page.
    • Export HTML for all pages when clicking Export to HTML from the Audio page.
  • On File > View APK Output Folder, need to create this folder if it doesn’t exist already.
  • Do not include 512x512px drawable-web icon in app resources.
  • Problems with file paths in projects when switching between Windows and Linux.

Scripture App Builder 1.10

Release date: 10 May 2016

New Features and Improvements:

  • Material Design color schemes:
    • ‘Color Scheme’ page added to New App wizard, giving you a choice of 20 Material Design color schemes.
    • Status bar color – a darker version of the app bar color
    • The previous gradient-style color schemes have been removed since they do not comply with Google’s Material Design app design guidelines. If you want a gradient app bar, this is still possible but you will need to modify the colors manually.
    • See Google’s Color Style Guide for more details.
  • Improvements to Word document (.docx) book import:
    • Hyperlinks
    • Numbered lists and bullet points
    • Tables
    • Character styles
    • Line breaks
  • Markdown hyperlinks in About box and Footer:
    • Allow use of markdown link formatting, where text to display is enclosed in square brackets [], followed by the link in normal parenthesis ().
    • Example: [Text to Display](http://www.example.com)
    • Example: [Email me](mailto:john@example.com)
  • Mixed case book names:
    • ‘Book Names’ page added to the New App wizard, asking if you want book names in all caps to be changed to mixed case, e.g. change “MATTHEW” to “Matthew”, etc.
    • This page is shown only if there are any all caps book names in the collection.
  • Audio:
    • Added option ‘At end of chapter, go to next chapter and continue playing audio’ in Features > Audio.
    • Uncheck this option if you want the audio to stop at the end of the current chapter.
  • Book-specific features:
    • See Features tab for each book, to specify book-specific features, such as:
      • Show chapter numbers
      • Continue playing next chapter audio at end of chapter
      • Show border around text
      • Show border around introduction (in some cases you might want to show a border for all chapters of a book except the introduction)
    • Only the relevant features above will be displayed, e.g. the border settings will not appear if there is no border image specified.

Bugs Fixed:

In the app:

  • If using \vp… \vp* to specify published verse number, the first character of the content was not shown if the content started immediately after the * without a space.
  • In footnotes, when there was a space after an end marker like \fr* or \fqa*, the space was deleted.
  • When the user changed the color theme (e.g. from normal to dark), the background color of the next page or chapter did not get changed.

In the app builder:

  • If changing book groups using the ‘Change Book Group…’ dialog in the books table, need to create the corresponding translation string ids.
  • Back matter books (BAK, CNC, TDX, NDX) should be sorted by default to the end of the book collection, together with GLO.
  • Styles needed for \fv (footnote verse number) and \fl (footnote label). Use superscript for \fv.
  • aeneas was reporting an error if you chose the ‘At X% of the silence between the two phrases’ option on the Phrase Boundaries page.

Scripture App Builder 1.9.2

Release date: 21 April 2016

Bugs Fixed:

  • Changing books in the app was giving ‘No content found in book’ errors.
  • Chapter range em-dash character was not displayed correctly in Scripture reference popup.
  • Plus some minor bug fixes.

Scripture App Builder 1.9

Release date: 18 April 2016

New Features and Improvements:

  • Book groups:
    • Added Group as a column in the books table.
    • Added ‘Change Book Group…’ to the right-click menu in the books table to allow for bulk-editing of book groups.
    • Select the books you want to edit, then right-click, ‘Change Book Group…’, specify the book group, then press OK.
  • Book order:
    • Added ‘Book Order’ page on New App wizard.
    • Allows you to specify the book order for Bible books, e.g. Western Protestant, Ethiopian Orthodox, Russian Protestant, etc.
  • Allow adding books of the same book id into a single book collection
    • This is needed, for example, when adding metrical Psalms as an additional book at the end of the Bible.
  • Documentation updates:
    • Installation Instructions: change of web page for downloading SDK tools.
    • Building Apps: added information on how SAB gets book names from Paratext Scripture Reference settings (BookNames.xml); more on glossary popups.
    • Using aeneas for Audio-Text Synchronization: added note to restart SAB if it is open when installing aeneas.

Bugs Fixed:

In the app:

  • In some cases, Xiaomi phones stopped on startup with the message ‘Reader – Could not open file: device_features’. This was due to the system adding additional files to the app assets which the app did not expect.
  • Books with introduction text only and no chapters were not shown if swipe between books was enabled.
  • If books were blank, access to subsequent books would be offset by a few chapters, e.g. if front matter book was blank, the first Bible book would be shown from chapter 3 onwards.
  • Search results: references were always using colons rather than the specified chapter-verse separators.
  • Contents menu: references were not displaying correctly for Right-to-Left.
  • Scripture reference popup: numerals were not being converted to the specified numeral system.
  • Audio player needs to check current book and chapter are the same before starting to play an audio file automatically after download.

In the app builder:

  • ‘Export to HTML’ caused an error where there were no non-empty chapters in a book.
  • Contents menu: could not change the order of the screens in order to set the home screen. Move Up/Down added to right-click context menu.
  • Right-To-Left mark characters in the book and timing files were causing synchronization problems and ‘Validate timings’ warnings.
  • No default style information found for \mt4 (Major Title 4).
  • INT (introduction) book should be ordered by default after FRT (front matter).

Scripture App Builder 1.8

Release date: 04 April 2016

New Features and Improvements:

  • Allow swiping between books
    • You can now swipe right from Matthew 28 to Mark 1, etc.
    • See Features > Navigation.
    • Enabled by default but can be disabled.
  • Added File > Open APK Output Folder in File menu, to make navigating to the APK folder easier.
  • Read book names and abbreviations from Paratext Scripture reference settings (BookNames.xml) if they exist before looking at \toc2 and \toc3.
  • Updated ‘Using aeneas’ documentation:
    • to explain how to get a working version of the NumPy Python module.
    • to use aeneas 1.5.0.1
  • Show sample text when choosing font in New App wizard.

Bugs Fixed:

In the app:

  • Multiple chapter range links not working properly in Scripture reference popups, e.g. Matthew 1—2; Mark 1:8—2:14.
  • ‘No Books found’ error message displayed when launching app.

In the app builder:

  • Images from Picture Story books defined in Word documents (docx) not read correctly if book added in New App wizard.
  • Signing alias not saved in some cases in New App wizard
  • Default APK filename should not contain non-ASCII characters
  • Warn if APK filename contains non-ASCII characters
  • Security configuration dialog boxes crashing
  • ‘User Interface’ tab title displayed in Spanish instead of English.
  • Layout issues on Grandroid and Add Changes pages.
  • Make New App wizard dialog wider for larger font size screen resolutions.
  • The gradle path was added at the end of the PATH environment variable, so if the user has gradle installed already and newer, it would break the build.

Scripture App Builder 1.7

Release date: 5 February 2016

New Features and Improvements:

  • Export to HTML:
    • Added dropdown menus for book and chapter selection.
    • Add language code prefix to the exported HTML files.
  • Audio-text synchronization:
    • Added option of creating a job zip file for aeneasweb.org, rather than running the aeneas synchronization locally.
    • Updated documentation for installing aeneas 1.4.0 on Windows.
  • Copyright and licensing:
    • Added copyright information for images in New App wizard.
    • Added Licensing page in New App wizard.
  • Security:
    • New security mode added: require access code to use this app.
    • See App > Security, and select “Require access code to use this app”
    • This feature is in beta. Please send us your feedback. Thank you.
  • User interface:
    • More Spanish user interface translations added.
  • App building:
    • Move to Target Platform page in Settings if no valid platform defined.
  • New icon.

  • Title bar and table/tree selection colors changed to match program colour.

Bugs Fixed:

In the app:

  • Telephone number link not working in about box.
  • Scripture reference links:
    • Handle verse ranges correctly for one-chapter books, e.g. Jude 3-8
    • Preserve n-dash in verse range if used in Scripture reference links.

In the app builder:

  • Build failed if the app name contained an apostrophe.
  • Could not start build in some cases if audio source type was modified.
  • Fine Tuning: Section heading text was being added to some of the verses.
  • Images: thumbnail not updated if trying to replace an image by one with the same name.

Scripture App Builder 1.6.1

Release date: 07 December 2015

New Features and Improvements:

  • Settings:
    • Better information on choosing the Target Platform.
    • Save and restore the width of the left tree pane.
  • Grandroid:
    • Replace the single Grandroid checkbox by two checkboxes:
    • Enable Grandroid font rendering up to Android 4.3
    • Enable Grandroid font rendering in Android 4.4 (not normally needed)

Bugs Fixed:

  • Audio files:
    • When working out the chapter number from the audio filename, take into account the actual chapter numbers in the book.
    • Default app names were always set to “New App 1” even when this project name already existed.
  • Fonts: the Harmattan font file path was not set correctly.

  • Default APK filename should not contain accented characters.

  • Book collection table:

    • Row heights not being set correctly after book reordering.
    • Cursor not reset to the default cursor if the selected row was not moved.

Scripture App Builder 1.6

Release date: 19 November 2015

New Features and Improvements:

  • Update book files from original source:
    • If you change any of the original book files, you no longer need to remove the book and add it again.
    • Select the book(s) in the books table, right-click and ‘Update from Original Source’.
    • Note that this feature will only work for books added in recent versions of SAB (the original source was not recorded in earlier versions).
    • Added ‘Last Modified’ date/time column to books table.
  • Audio File Distribution:
    • Changed audio file distribution method from a global app setting to a file-by-file setting.
    • Some files can be chosen to be packaged inside the apk file, others downloaded from the internet.
    • Different files can have different internet download sources.
    • Different files can have different FCBH DAM ids. So an app can contain both OT and NT audio files from FCBH – since the DAM ids for NT and OT files are not the same.
    • See the new ‘Audio’ page and ‘Audio Files’ tab, and the ‘Change Audio Source…’ action on the Audio Files popup menu. The ‘Audio Distribution’ tab has been removed.
    • Updated ‘Building Apps’ documentation.
  • Decorative borders:
    • You can specify an optional decorative border image to be displayed around the text. See Images > Border.
    • Specify the portrait border image and a landscape border will be created automatically.
    • When the app is built, the border image is cut into 8 component images (top-left corner, top, top-right corner, left, right, bottom-left corner, bottom and bottom-right corner). These will be stretched according to the screen size.
    • Border image background and foreground colors are adjusted to match the color theme, i.e. normal/dark/sepia.
  • Display of Scripture text after clicking on reference link:
    • You can now choose different settings for Scripture links in the main screen and Scripture links in a popup.
    • See Features > References.
  • Audio for picture story book section headings:
    • If you have audio for section headings in story books, use the following labels:
    • 1s1, 1s2, 1s3, etc. for section headings on page 1,
    • 2s1, 2s2, 2s3, etc. for section headings on page 2, and so on.
  • Audio synchronization using aeneas:
    • Linux: Installation of aeneas packages are included within the main SAB install.
    • Use ‘aeneas_check_setup.py’ instead of ‘check_dependencies.py’ if it exists.
    • Updated documentation to change command line install of lxml which had stopped working.
  • USFM Markers:
    • Handle \cp marker for changing published chapter character, e.g. A, B, C, rather than 1, 2, 3.
    • Handle \mte and \imte markers for major headings at ending.
  • Reference links within non-Scripture books:
    • Handles \xt Mat 5:4\xt* format in book text to create a link to another book.
  • Sort apps in alphabetical order:
    • Right-click on ‘Apps’ (the root tree node) and select ‘Sort Apps in Alphabetical Order’.
  • Some extra configuration options for iOS apps (coming soon).

Bugs Fixed:

  • Changes to the color scheme not happening correctly.

  • When adding audio files for one-chapter books (Jude, 2 John, etc.), the chapter should always be set to 1.

  • Incorrectly importing some types of Word document (.docx).

  • Unable to save changes to the HTML export folder in the Settings dialog.

  • Export to EPUB:

    • Fixed EPUB validation errors (using EpubCheck validator)
    • Audio files not copied properly.
    • Problem with footnotes in an audio-sync’ed chapter.
    • Put document data into OEBPS sub-folder within EPUB file.

Scripture App Builder 1.5.1

Release date: 16 October 2015

New Features and Improvements:

  • Audio synchronization using aeneas:
    • Verify aeneas folder and version in wizard. Minimum aeneas version is now 1.3.0.
    • Added more character replacements, e.g. Ñ > Ny, modifier letter apostrophe, etc.
    • Added –skip-validator for aeneas 1.3.0.
    • Show tail detect settings for each task.
    • Updated aeneas documentation to simplify the aeneas install process: uses Miniconda rather than needing to download whl files, no longer need scikits.audiolab module.
  • Contents Menu:
    • Can now drag images onto the Contents Item dialog.
  • Documentation:
    • New document on Distributing Apps.

Bugs Fixed:

In the app:

  • App crashed on some phones when searching for audio files in the phone memory or SD card (affected older Android versions).
  • Did not play some audio files from the assets because they had been compressed.
  • More exception handling in the app.

In the app builder:

  • Not encoding ampersands “&” in footers correctly.
  • Signing page: Move focus to the password field after selecting a keystore file with the Browse button.
  • Command line build: null pointer exception if project filename is not specified correctly.

Scripture App Builder 1.5

Release date: 06 October 2015

New Features and Improvements:

  • Audio synchronization using aeneas:
    • Enabled ‘Auto detect head’ feature on ‘Start of File’ wizard page.
    • Added ‘End of File’ wizard page, including ‘Auto detect tail’ (which works best in aeneas 1.2.1 and above).
    • Default to writing timing files to the app’s data folder in App Projects.
    • Added aeneas version number to first page of wizard.
    • Output the time elapsed while processing tasks.
    • Added more default character replacements.
    • Added more troubleshooting to aeneas installation documentation.
    • Added \zs marker to mark invisible text that should be seen by aeneas during synchronisation.
  • Fine Tuning timing files:
    • Produces a browser-based timing file fine tuner (credit to Firat Özdemir for inventing this method).
    • Right-click on a row in the Audio Files table and select ‘Fine Tune Timings…’.
    • Click on each row one by one and use +/- to fine tune the start.
    • Click the ‘Save Changes’ button when finished and copy the modified files back to your timing folder.
    • Added Fine Tuning section to aeneas documentation.
  • Styles:
    • Added font styles (color, font-weight, etc.) to all paragraph (div) styles.
    • Removed character (span) styles associated with paragraph (div) styles.
    • Added custom colors: CustomColor1, CustomColor2, etc.
  • Word document (docx) books:
    • If paragraph style names are named after SFM markers, use these markers when doing the docx to SFM conversion.
    • Example: you can define a song book in a Word document using a ‘c’ paragraph style for each song number, ‘s’ styles for each song title, ‘q1’ styles for the verses and ‘q2’ styles for the chorus.
    • See the updated ‘Song Books’ section in the Building Apps document to describe how to use Word documents for defining song books.
  • Book Source page:
    • Added font size increase/decrease buttons.
  • Audio Files:
    • Added Duration (mm:ss) column to Audio Files table.
    • Added ‘View Audio Folder’ to popup menu.
  • Building App:
    • If a warning is shown to tell the user to go to fill in some missing information, take them to the relevant page.

Bugs Fixed:

In the app:

  • Stop audio playing if the Contents Home button is pressed.
  • Audio phrase highlighting:
    • Do not include double speech-mark (“) after a space as part of the preceding phrase.
    • Do not include a space in highlighting if using a space as a phrase-ending character.
    • Added more checks for the existence of timing files.
    • <span class=”glossary”> was appearing in the display text in some situations.

In the app builder:

  • Audio Synchronization:
    • Do not start a new phrase in the last 3 characters of a phrase.
    • Use ‘tsv’ rather than ‘tab’ in the aeneas syncmap output configuration.
    • ‘Synchronize using aeneas’ was not displaying on Audio Files popup menu if it had been installed to the default folder.
    • Audio filenames with special characters were not being found on Linux.
  • Export to HTML:
    • Not setting last timing end time correctly.
    • Audio sync not working for French language systems, where decimal point is a comma.
  • Build failed if there was an apostrophe in the app name.
  • Word document (docx) books: paragraph styles were not being preserved between pages if there was a page break.
  • Images appeared multiple times on the Illustrations page if the same docx book was added again.
  • Adding audio files: SAB was confused as to which chapters to assign to if underscores surrounded the chapter number in the audio filenames.
  • Book and audio filenames containing an ampersand (&) character caused read problems in the app project definition file.
  • Translations:
    • Missing French translations for Security page and Contents title.
    • Not enough room for chapter-verse separator label in French.
    • Button for aeneas wizard too short for French label.
    • Added missing Spanish translations for app menus and messages.

Scripture App Builder 1.4.1

Release date: 24 September 2015

New Features and Improvements:

  • Audio synchronization using aeneas:
    • Added