Skip to content

Deploying to the Table

Jump to bottom
Will Granger edited this page Dec 4, 2019 · 6 revisions

Deploying to the table is a bit convoluted as we are using ClickOnce to deploy in a way ClickOnce isn't made to publish (see ADR on ClickOnce). For the most part, things work smoothly, but you may find yourself reading the troubleshooting section of this wiki for more guidance.

Publishing a New Version of the App

Prerequisites: Google Drive File Stream

  1. You will likely need a copy of the app key to publish the app. You can obtain this from Will Granger ([email protected]).

  2. Make sure the following items are marked under the properties section of the app:

    • Security: This is a full trust application
    • Publish: The application is available offline as well
    • Publish: Increment the Publish Version
    • Signing: Sign the ClickOnce manifests

  3. We've been using ClickOnce to publish to a Google Drive File Stream path: G:\Shared drives\Citizen Science\Touch Table\. The path should be defined under Publish/Publish Location under the properties setting of the app. That path links to a shared Google Drive location that is accessible on a local machine through Google Drive File Stream. When publishing, the app will publish to that path. Any other machine that has Google Drive File Stream (and is a member of Zooniverse) can then access the setup file that is created on that same path to install the app.

  4. Make sure you choose a Publish Version that is not being used by incrementing the most recent version. You can check the current publish version in Google Drive by visiting Citizen Science\Touch Table\Application Files and making note of the most recent version number.

  5. Clean and Rebuild the app for good measure

  6. Important: Make sure you publish the Release (as opposed to Debug) version of the app using the dropdown at the top of Visual Studio. However, you may need need to reset the App.config values to the (App.Release.config)[https://github.com/zooniverse/galaxy-zoo-touch-table/blob/master/GalaxyZooTouchTable/GalaxyZooTouchTable/App.Release.config] values as the config transforms sometimes will not automatically select the correct config (debug or release) when publishing. Refer to the "important" section at the bottom of this page to ensure all went as expected.

  7. Click "publish now" on the publish section of the properties window. After publishing, the "setup" file should change under G:\Shared drives\Citizen Science\Touch Table\. Double clicking that file should install the touch table on your device. The app should open after a successful install. If the app doesn't open, or you cannot open it afterwards, please refer to the troubleshooting section of this wiki.

Important

Always a good idea to do a test classification on the newly installed app to make sure the classification count increments for the project. You can check the counts increment on uscientist.org or check a data export for the expected classification. It's very easy to accidentally publish and install a staging version of the app.

Clone this wiki locally