Development Build
Test App Packages:
- Let's Practice ZSL (4567)
- Let's Measure (3730)
- Let's Train (4111)
- Let's Practice Vocab (3777)
- Let's Practice Production (3805)
App updates:
- This app runs image label properly using the new Drupal 9 API.
- Bugs related to pulling down and playing app-wide instructions have been fixed.
- There is now an option in general settings to turn of slide refresh.
- Fixed a markup bug on choice-feedback slides
Stable Release
Test App Packages: 3730 (Let's Measure), 4111 (Let's Train), 3805 (Let's Practice)
Updates:
- Navigation shows up properly on text select and image select
- On image select, the corrective "try again" popup only shows up if this popup feature is checked on the app package
- Better error handling during Let’s Measure and Let’s Train slide progression
- Adjusted content API endpoint for Drupal 9 compliance
- Added better error handling for unresponsive servers while downloading schools and districts
- Silenced a "slide data not found" error message.
- Added logic to bypass the "real data vs practice" screen for apps without school select options
- Fixed a bug that was causing the user type to be set to "teacher" for trainer apps without a teacher-class-pupil hierarchy.
Recommended tests:
- USB Import test with a "blank" tablet holding no content - check that all files have been imported
- Set the app to the testing environment using the above steps so it points to the stage server
- School selection (Use Muchinga > Chama > Test School)
- Teacher, class, and pupil account creation
- Gradebook marks entry
- Go to view marks and examine data
- Visit the lesson select screens in Let's Practice and Let's Train
- Manual and automatic upload tests
- Manual geolocation upload test
Cautionary Notes:
- Because uploaded marks can only be overwritten but cannot be deleted at this point, supervision and review of marks entry prior to upload is recommended.
- If an assessment for a given class, term, and week with incorrect data has been already uploaded, and that assessment is then deleted on the tablet by erasing all the marks, the uploaded marks will remain in the database until the assessment is restarted and uploaded again.
- It is not possible to record data on a class assessment wherein all students show up and earn zeroes.
- If a class only shows up for one out of several days for one assessment, it is up to educational leadership to decide whether to mark that student absent for the whole assessment or mark questions on missed days incorrect. No partial absences can be recorded.
Earlier Builds
Test App Packages:
- Let's Practice ZSL (4567)
- Let's Measure (3730)
- Let's Train (4111)
- Let's Practice Vocab (3777)
- Let's Practice Production (3805)
App updates:
- This app is the first app to pull content from the Drupal 9 website.
- The app should be compatible with both Drupal 9 and Drupal 7 content.
- Bug fixes have been implemented for the memory cards template.
- Bug fix that helps to ensure a return to the Stepping Stone download welcome screen after an uninstall.
- The app no longer checks for USB Flash drives in Android 11 since they are not detectable with this OS.
Test App Packages:
- Let's Practice Vocab (3777)
- Let's Practice Production (3805)
- Let's Practice ZSL (4567)
App updates:
- Sequencing and choice-feedback templates now support audio.
- Memory cards game template is now working.
- Download process has been optimized with fewer steps.
- Foundational code for Drupal 9 is in place.
- The app no longer checks for USB Flash drives in Android 11 since they are not detectable with this OS.
Requirements and Instructions, updated 2021.06.08
Test App Packages:
- Let's Practice Vocab (3777)
- Let's Practice Production (3805)
- Let's Practice ZSL (4567)
App updates:
- Finger spelling reformatted according to design spec.
- Sequencing slides now indicate correct sequence by turning the sortable items green.
- The "selection bank" label has been removed from image label.
- Audio issues on image select seem fixed and are ready for re-test.
- Sign language icon shows up on menu. A download of the app package is required to pull down the image.
- Instructions for image select and several other slides should only play on the first slide of its type encountered during a chapter walkthrough.
App updates:
- Added single-slide download, which can be activated by swiping from the top down down on a given slide while connected to the internet.
- Added support for finger-spelling activities.
- Added an 'activity complete' message for image label.
- Modernized image label so that it now works with the new swipe controls.
- Numerous bug fixes with image label and image select.
- Fixed an "undefined" bug in the sequencing activity.
- Added support for app-wide correct and incorrect sounds.
- Fixed a back button bug on the lesson complete screen.
- Adjusted padding on image select button to accomodate the range of letters.
- Fine-tuned swipe controls.
Content Package version 1.01 - 2021.06.08
Requirements and Instructions, updated 2021.06.08
App updates:
- General stability improvements to app state storage
- no more warning popup on class select if let's measure is not in the system
- Removed the “tries maxed out” popup message after the max number of tries are exhausted. All that happens is the next button shows up.
- Removed unnecessary popups when audio gets interrupted and an activity title cannot be retrieved.
- On a video slide, playing a video completes the activity.
- Added caching support for switching languages.
- Removed top spacing on class home screen for smaller tablets.
App updates:
- Bug fix for graphic-text-audio slides with no text.
- General code hardening and syntactical improvements on slides showing graphics, text, and audio.
Updates:
- Text Select: Support for incorrect feedback sound
- Text Select: support for correct letter or word sound
- Class Home: Let's Practice Icon should remain centered regardless of app name width
- Lesson Select: Added styles to language tabs to handle text overflow
- Added support for new Choice-Feedback template
- Added support for choose-your-own adventure GTA slides
- Additional layout flexibility for GTA slides
- Support for previous and next arrows rather than hands
Updates:
- Assessments created retroactively for new pupils now upload properly.
- On gradebook select, the buttons representing gradebooks with data have dark blue borders.
Bug fixes to upload functionality:
- Editing a class no longer changes the upload status of the class's teacher.
- Adding an assessment now changes the upload status of the pupil.
Bug fixes to View Marks:
- In the Year totals column, the correct averages of all term scores show up for each pupil.
- For each pupil, the correct percent present now should show up for each term and year.
- fix to how absences are handled in view marks wherein multiple absences for a pupil show up as N/A in the term total rather than 0%.
- if you add a pupil to a class with prior assessment data, the pupil is automatically marked absent for those prior assessments.
- attempted fixes to the "-1" and "-inifinity" errors that were showing up on the view marks screen in v2.40
Updates to View Marks Screen
- In View Marks, two new rows have been added - percent present and the score average - for week, term, and year.
- A blank assessment with no marks or absences will not show up in in the table.
- An assessment that does have at least one mark or absence will show up in the table.
- Absences do not show up in the pie chart.
Updates to Enter Marks Screen
- Cells in rows marked absent will have “A” instead of “X” in case we ever implement check versus “X” logic later in the gradebook.
- If you add check marks to some but not all of the rows in a gradebook and then tap save, all rows will save and blank rows will save as zeroes.
- If all check marks are removed from a gradebook, all assessment data will be erased for that term and week. This means data for that class-term-week combination will no longer show up in enter marks, view marks, upload status, or upload analytics.
- Each local class object stores the machine ID's of deleted assessments.
- If a gradebook for a given term-week is cleared and re-started, the newly uploaded data should replace the older data in the database.
Updates to Let's Train Module
- Bug fix to an alert error that sometimes appears when a slide button is pressed on the slide select screen.
Updates to error handling during setup
- Because setup steps may evolve, the "try again" directive that may show up due to a permissions error with an incorrect Scalefusion setup method is more general.
Auto-generation of test pupil accounts
- So it is efficient to test how blank rows are saved and handled, pupils on this build are auto-generated without their assessments when you are on the Test School or pointing to the testing server. Fifty pupil accounts are generated at a time.
Updates:
- The app version - in this case, 2.39 - shows up on the general settings screen under a new “app info” section.
- The IMEI number now shows up again more consistently in Android 9.
- In order to gain access to the IMEI number, the app will ask for phone permissions during setup.
- The behavior for insufficient storage permissions should no longer be a series of obscure alerts. Instead, all functionality should be locked down and the welcome screen explains the problem while providing a summary of the ScaleFusion setup instructions.
- The “Welcome to SteppingStone” has been changed to “Welcome to SteppingStone” on the pre-setup screen.
- The year dropdown is wider by 10 pixels so that the word “- Select -“ is fully visible in its initial state.
Updates:
- On the View Marks screen, the percentage of grades that are absent show up.
- The pie charts are now based on week scores rather than term averages.
Version 2.36 - 2021.01.23 (Previous Stable Release)
Updates:
- When creating a teacher or editing it for the first time, the slider that determines the number of blank classes to be created is set to 1.
- When the app is set to practice mode, the only button on the app settings screen is the general settings button.
Updates:
- Added a short period of post-tap non-responsiveness to the add teacher, add class, and add pupil buttons to prevent errors.
Updates:
- Scroll buttons have been added to the editable gradebook. Tapping a button will cause the gradebook to scroll down by six rows at a time.
- A bug that was causing the upload process to stop unexpectedly has been fixed.
- When switching schools, the device ID should now sync properly with the school ID in the data that gets sent up to the cloud.
- Improved “no results behavior” in upload analytics so that the “no data” circles show up more consistently.
- Extra line breaks are now removed on Let’s Train and Let’s Practice slides.
Updates:
- In an app without a built-in "environments" feature that has not yet uploaded marks, tapping the device ID four times on app settings screen will cause the "environments" icon to replace the "upload analytics" icon.
- Tapping the environments icon will activate a password prompt. Entering the correct password and tapping "GO" takes you to the "environments" screen.
- The "practice" environment has been renamed as the "testing" environment.
Updates:
- The "switch app modules" button no longer shows up in app settings.
- Instead, an "upload marks" shortcut button shows up at the bottom right.
- This button will take you to the upload status screen as long as you are online, have selected a school, and have active teachers.
- On the upload status screen, the button label says "upload marks" rather than "upload progress."
Updates:
- USB import process has been optimized and should run faster, if the type of flash drive and other conditions remain the same.
- The files and folders are counted before the import begins, during which the file and folder count is visible and a spinner is present.
- Import progress is now indicated with the standard progress bar and a percent complete indicator.
- The import button disappears during an import operation.
- There is a cancel button to the right of the import progress bar that allows an import operation to be cancelled.
- If the USB drives is removed during an import, then the import automatically cancels.
- The import instructions change messages if the flash drive is removed or when an import begins.
- Any errors that occur during import are printed under the progress bar.
Updates:
- turning on the automatic geolocation upload step during data upload.
Updates:
- displays the total number of files and folders imported after a USB import
- now sorting classes by year on class select
- displaying class labels with Year, Grade, and Class for active classes on class select, header on class home, and header on app main
- turning off the automatic geolocation upload step during data upload
- fixed issue where middle name could not be deleted
- spinner disappears after saving geolocation when there is no connectivity
Updates:
- Critical auto-upload bug fixed.
- Updated the icon that shows up on the tablet home screen so it reflects the most recent Let's Read Logo.
- Silenced errors related to IMEI retrieval.
- No more attempts to retrieve IMEI in Android 10 since it is inaccessible.
Updates:
- Critical upload bug fixed.
- Text in Let's Practice and Let's Train is left-justified rather than centered.
- The "add test data" error should be fixed. Marks should now show up in the gradebook.
- Tapping the "add pupil button" should result in errors less often.
Updates:
- Manual ID field is disabled by default
- Manual ID field can be enabled by tapping the header with the lock icon
- Enabling manual ID field is PIN-protected
- Deletion of teachers and classes is PIN-protected
- More descriptive spinner messages during import
- The pupil edit screen in Let’s Practice has no fillable name fields; only the icons an the printed full name
- The permanent practice environment indicator is now red, while the temporary practice mode indicator is green
- Bug fix to middle name field
- Add pupil button no longer shows up on Let’s Practice Pupil select
Updates:
- The number of pupils for “add test data” is back at 50.
- In practice mode you are limited to three teachers.
- Device object has a new active property that gas s
- Device object only uploads if active is set to true.
- The device object’s active property is set to true when geolocation is set and uploaded — both when it is set manually and right before data upload.
- Create and Edit forms are now scrollable.
- Retrieving the correct list of lessons or assessments when switching app modules - before download, at class home, and at switch apps
- Fixed bug involving practice mode not turning off when disallowing it in general settings
Updates:
- The grade shows up before the class on the app main screen.
- "Upload progress" has been changed to "upload marks" on the app main screen.
- The right margin of the left logo has been increased from 12px to 20px when it is right next to the right logo.
- There is now an option for left-justified logos.
- Each edit button now has an invisible “hot spot” (diameter of of 50 pixels) that makes it respond more readily to taps.
- Middle name is no longer required and no longer has placeholder text if left blank
- Middle name now shows up in pupil table and gradebook
- Middle name is disabled in Let’s Practice pupil select
- Practice mode automatically turns off if you uncheck “allow practice” in general settings
- Icons added to graphic-text audio slides
- If you switch off "allow practice mode" while in practice mode, you are no longer stuck in practice mode.
- Adding a class year and class name are now required for adding pupils to a class.
- Andika font is now being added to the Let's Practice slides and will override the font added in the CAT.
Known Issues with planned resolutions:
- The device ID still gets sent up to the server even if there is no assessment data entered.
- There is still no limit to the number of teachers, classes, and pupils that can be added in practice mode.
- The app seems to forget that some Let's Practice lessons were downloaded.
- The manual ID field in general settings needs to be password-protected.
- Import functionality for all three app modules needs to be verified.
Test App Packages: 3730, 4111, 3805
Updates:
- Download recovery now requires a PIN code.
- Let's Practice User Select only allows for icons to be changed.
- Practice mode has been implemented.
- "Allow practice mode" option is now in general settings.
- If you go to Let's Practice without a pupil in the class, an inactive pupil is added on the fly.
Bug fixes:
- Add Test Data error has been fixed.
- "docs not iterable" error has been fixed.
Known Issues with planned resolutions:
- If you switch off "allow practice mode" while in practice mode, you will be stuck in practice mode.
- In Class Select, tapping the edit button on the rightmost class does not always work.
- Backing out of a class before entering a year can inadvertently mark it as active, which can result in upload errors.
- Downloading is not as efficient as it could be, in that district and school info get downloaded three times — once for each app module.
- Auto-upload may still have issues.
- Andika font still needs to be added to the slideshows.
- The device ID still gets sent up to the server even if there is no assessment data entered.
- There is still no limit to the number of teachers, classes, and pupils that can be added in practice mode.
Updates:
- Compatibility with Practice apps and Discussion apps.
- Additional back navigation logic for Let’s Practice and Let’s Train
- Let’s Practice takes you to a user select screen
- Pupils can change the icons on their accounts
- Let’s Practice and Let’s Train icons are now properly styled and take you to the correct places.
- Nav buttons automatically unlock when you get to lesson select.
- Manual ID can be entered on the General Settings screen.
- If there is only one lesson group and one lesson, the side nav disappears and the one lesson title appears on the same line as the main title.
- Content slides are automatically marked as completed when a user visits them.
- Statistics files for each class now include information on categories.
NOTE: While enrollment will not show up anymore in the Let’s Read apps, this is due to a change to how the app packages are configured on this authoring site and not actually to the app build codebase.
Test App Package for v2.19 and below: 3730
Updates:
- Auto-upload can now happen more than once per session.
- Two startup errors fixed for Let's Practice demo.
- Fix to layout of "lesson complete" screen.
Updates:
- You can now select individual teachers for download recovery.
- Uploading teachers and classes should go faster.
- Absent values are now always treated as strings, which fixes a bug in "view marks."
- The spinner on the geo download screen no longer times out.
Earlier Production Builds
Updates:
- The "add pupil" button should no longer cause issues due to multiple taps.
- Auto-upload should automatically cancel when you tap "teacher select."
- Improved handling of dropped connections during data recovery download.
Updates:
- After an auto-upload, scroll down and you will see a set of pie charts depicting the upload statistics, which show up below the navy block on the welcome screen.
Updates:
- Fix to data recovery screen wherein uploaded teachers should show up more reliably on the teacher menu when a given device is selected.
Updates:
- Environment now locks in auto-upload functionality.
- Bottom padding in large gradebooks fixed for Pie T295 tablets.
- When generating test data for a given class without a set year, the year field is automatically set to 2020.
Updates:
- Auto-upload functionality.
- A switch in general settings that allows auto-upload to be turned on or off.
- Download recovery functionality.
- The "year" field is now required when creating or editing a class.
- General improvements and optimizations.
- Bug fix to enrollment status display in pupil table.
Important usage notes:
- Lollipop Production Apps that are version 1.93.1 can upgrade to this build.
- This build is intended for completing the data entry on tablets running the Lollipop OS.
- Please use Muchinga > Chama > TEST SCHOOL for testing.
Updates:
- The download icon on the initial welcome screen is vertically centered on Lollipop tablets.
- External directory check should now only occur on tablets with OS 9 (Pie) or above.
- In the event the device IMEI number cannot be accessed, the app no longer reports an error.
- Pupil enrollment flag should upload successfully now.
- Enrollment status and grade now save as integers rather than strings.
- The spinner that shows up after saving geo settings should stay up for a maximum time of one second, after which you 2,2. be brought to a new page.
- Errors on the geo settings page now show up as on-screen messages rather than alerts.
- The current class ID now shows up on the teacher profile screen as long as you arrive there from a page other than teacher select.
- The gradebook select screen should consistently show three columns of buttons on 7-inch Lollipop tablets that don't respond to CSS Grid.
Bug fixes:
- Fix to gradebook save logic to prevent loss of data.
- Marks that are not saved due to app interruptions are cached and saved when you revisit the gradebook.
- Double-taps on class edit buttons, which cause errors, are prevented.
Updates:
- The download recovery feature has been added.
- Downloading data will lock the app in its environment.
- App welcome screen shows up properly after an uninstall / reinstall.
- The device auto-update now only happens on the welcome screen when the app boots up.
- The welcome screen no longer flashes white during startup.
- The gear button no longer causes errors due to multiple taps.
Updates:
Storage
- The app now stores data in the external root directory, which survives if the app has to be uninstalled.
- This directory is located in "Internal Storage" and is called "Steppingstone."
- To completely uninstall the app, this directory must manually be deleted to fully erase the app's its data.
Uploads
- You can add a custom device name in general settings that will then be uploaded, making the device more identifiable on the dashboard.
- App sends upload analytics to the Microsoft Azure app center.
Background Processes
- Navigation is usually disabled during a background process.
- Some of the spinners that show up during the longer background processes now have progress bars.
Production and Practice Modes
- The user can choose between practice and production modes using the new "environments" screen.
- An environment indicator in the lower left hand corner shows up when an app is in practice mode.
- After the first upload, the app becomes locked in that environment.
User Experience
- The user is warned if he/she changes the grade of a class containing marks.
- The device Id now shows up on the app settings screen.
- Schools and locations are alphabetized in the geo settings dropdowns.
Generating Test Data
- "Add Pupils" buttons now say "Add Test Data" and show up for all schools when the app is in stage mode or when a test school is selected in production mode.
- Upload errors no longer show up a alerts but occur at the bottom of the upload status screen.
- A progress bar shows up during the upload.
- The language dropdown and "add schools" have been removed from geolocation.
- Classes without pupils now upload without errors.
- Academic year field is fully implemented.
- Fix to cancel and submit button colors on class create screen.
Primary fix:
- "View Marks" and "Enter marks" now have a backup process for retrieving data if a stat file is corrupted.
Other updates:
- Data Transfer Screen: the export button used for writing data to flash drives no longer shows up on pie tablets since export functionality is not supported in Pie.
- Data Transfer Screen: better error handling when importing a directory with incomplete (or non-existent) contents.
- Welcome Screen: when you remove a USB drive from a tablet with no content - it goes back to its "blank" screen and does not erroneously suggest that it is ready for use
- Download Screen: you get a popup if you try to download an individual assessment while offline
- App Navigation: back buttons are more responsive.
Updates:
- Code fix to ensure that data is being stored in the correct app directory.
- On editable gradebooks, the submit button is below the last row in the gradebook, rather than on top of it.
- Editable gradebook automatically saves when you press the home button or the user profile button.
Updates:
- On editable gradebooks, the submit button is below the last row in the gradebook, rather than on top of it.
- Editable gradebook automatically saves when you press the home button or the user profile button.
Updates:
- on the assessment download screen, the "waiting to reconnect" spinner is more reliable about disappearing once the app reconnects.
- gradebook bottom spacing is now responsive to the operating system and the number of students.
- gradebook layout adjusted so that you can tap the last row with enough scrolling.
- "lessons" changed to "assessments" in download screen instructions.
- centered the icon a bit in the "enter marks" button on the Let's Measure main screen.
- added code that should allow for HTTP (in addition to HTTPS) requests on Pie tablets.
Updates:
- General stability improvements to download interface.
- Improvements to file size check logic.
- Refinements to download logic.
Updates:
- General stability improvements to download interface.
- Improved handling of dropped connections during lesson download with less alerts and more attempts to reconnect.
- Fixed bug that disabled gradebook buttons after they were tapped when there were no pupils in a class.
Updates:
- If you try to upload while offline, there is a reminder that prompts you to connect to a network.
- The upload screen instructions indicate what server you are pushing to.
- Clearer spinner message while uploading assessments.
Updates:
- Better download connectivity and error handling.
- Import errors with code 9 are suppressed.
- Bug fix to homescreen error while offline.
Updates:
- now uploading the correct version number
- swapped order of "view marks" and "edit marks" on app main
- added new app icon
- app title is now "Let's Measure" rather than SteppingStone
- fixed another upload bug related to assessment filepaths
Bug fixes:
- Corrected upload error that was causing assessments to be saved to the wrong directory during an upload status update
- Fixed pupil edit screen bug
- Now updating upload status of pupils to "needs to be re-uploaded" status after updating them on the pupil edit form
Version 1.76 - 2019.11.08 (Development Build)
Note: We have not yet tested how well 1.69 upgrades to 1.76, so hold off on using this with data-bearing tablets.
Updates:
- Improvements to app navigation.
- Removal of general settings stage.
- Improvements to upload.
- Number of classes slider is now on teacher edit screen.
- Currently hiding the admin assessment button in app main.
- "Exit app" button added to home screen.
Version 1.75 - 2019.11.05 (Development Build)
Note: This build should be able to support an upgrade from 1.68 or 1.69.
Updates:
- Added an upload dashboard that shows you basic statistics after an upload.
- Fixes to active / inactive logic.
- Added "switch schools" screen, accessible via the settings menu.
- Fixes to teacher deletion and replacement functionality.
- Fixes and optimizations to upload logic.
Version 1.74 - 2019.10.31 (Development Build)
Note: Only try this build with a newly installed app with no data, as legacy code has not been added yet.
Updates:
- The styling from EDC's digital design group has been implemented.
- The app no longer downloads the list of assessments or classes from the performance tracking database. (Critical fix)
- Teachers, classes, and pupils must have been made given names and thereby made "active" in order to be used and uploaded.
- When selecting an inactive teacher, class, or pupil, you are immediately brought to an edit screen where the name must be filled in.
- After selecting a school, there is an additional configuration stage where you get to select starting numbers of teachers, pupils, and classes.
- You can now select a unique starting number of teachers for each grade - same goes for pupils.
- Grade three should now have its own gradebook with unique question sets.
- You can now designated students as un-enrolled on the edit screen.
- The grade now shows up on teacher, class, and pupil buttons.
- The class and grade show up on class home, Let's Measure main, gradebook select, and editable gradebook,
- You can now change the grade of a teacher, which will affect the grades of any future classes that are created.
- Pupil table now shows grade and active status.
- Device ID now a concatenation of device UUID and schoolId.
- Each school has its own teacher list file, which should reduce the incidence of large list files and therefore allow the app to handle higher numbers of schools.