Skip to content

Deploying to the Table

Jump to bottom
Cliff Johnson edited this page Aug 2, 2024 · 6 revisions

Deploying to the table uses ClickOnce to deploy (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 App (make sure your local machine is logged in to your Adler/Zooniverse Google Drive account and you can access the touchtable folder), Microsoft Visual Studio (for solution, build, test capabilities)

  1. You will need the app key to publish the app. The current key is saved on the Zooniverse Surface laptop and the certificate's internal password is in Passbolt under "Galaxy Zoo Touch Table Key". Cliff Johnson ([email protected]) was the last to use/renew the certificate.

  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 path: G:\Shared drives\Science Engagement\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 app. When publishing, the app will publish to that path. Any other machine that has the Google Drive app (and has permissions via Adler or Zooniverse) can access the setup file that is created at that 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 Science Engagement\Touch Table\Application Files and making note of the most recent version number (e.g., GalaxyZooTouchTable_1_2_5_0).

  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\Science Engagement\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 DB file or 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