Test, Publish and Roll Back a Handheld App Version
Test a small workflow in Simulate, fix what the Checklist finds, publish version 1.0.0, publish a change, then restore the older version and publish it again.
What you will learn
- Read the Checklist and Problems list and fix what they find
- Run a workflow in Simulate and read its Trace
- Publish a version and choose Fix, Feature or Major for the next one
- Restore an older version into the draft and publish it as a new version
Transcript
In this guide you will test a small app in the simulator, fix what the checklist finds, publish it, publish a change, and then go back to an earlier version.
This small app, Dock Check, has an Item to scan and a Note. Open Workflows, press Workflow, and choose A field is entered. Pick the Item field and name the workflow Item scanned. The workflow exists, but so far it has no steps.
Studio checks the app as you build. The guide bar says there is one thing to check before you publish. Press Go to Publish. The Checklist lists the problem: Item scanned does nothing yet. The same list opens as Problems with Control Shift M. This one is a warning, so publishing is still possible, but it is worth fixing. Click the problem, and Studio jumps to it.
Press the plus under the trigger, and choose Show a message. Type the message: Item scanned. Check the label. Now the workflow does something, and the problem is gone.
Before you publish, test it. Press Simulate, and scan an item number. The phone runs the workflow, and the Trace under it lists each step that ran, with a check mark when it worked. Nothing is saved to your data, and no phone is affected.
Now publish. Open Publish. The Checklist says Nothing to fix, and that publishing creates version 1.0.0 of a new app. Press Publish 1.0.0. The version list on the left now has 1.0.0, tagged current. Phones download it on their next sync.
Now change something. Go back to Workflows, open the Item scanned workflow, and click the message step. Change the message to: Item scanned. Count it now. And set the tone to Success. The top bar now says the draft has changes.
Open Publish again. The Checklist says what changed since 1.0.0: one workflow. You never type a version number. Choose Fix for a small correction, Feature for something new, or Major for a different app. Each choice shows the number it makes. Keep Fix, and press Publish 1.0.1.
The version list shows every version, with the date and who published it. The current one is the version the phones run. A version that is not current can be restored or deleted from its menu. The current version cannot be deleted.
Suppose version 1.0.1 causes trouble on the floor. Open the menu of version 1.0.0 and choose Restore this version into the draft. Studio explains that your draft becomes exactly 1.0.0, and nothing changes on the devices until you publish it. Press Restore 1.0.0.
The draft is back to the older workflow. The Checklist lists it as a change since 1.0.1. Press Publish 1.0.2. The old app goes out again as a new version, so the history is never rewritten, and the phones get it on their next sync.
That is the cycle. Test in Simulate, fix what the checklist finds, and publish. Each publish is a new version, and if one goes wrong, restore the version before it and publish that.
Related
More guides
Start with one device today
Free for Studio, one handheld and one worker. No cloud account, no credit card.