React Native

To create a new assignment in React Native, click into one of your courses, and then click Add assignment. Choose React Native from the drop-down list of available frontend frameworks and set the the rest of your assignment's parameters (deadline, etc.). Once the assignment is created, a new folder will be created in the private GitHub/GitLab template repository for the course in which you are added this assignment. This folder will contain a standard React Native project (created with Expo) structure.

Automated test-suite setup

If you would like to add tests that are automatically run by AssignmentOS against each student's solution to your assignment, you can add these as end-to-end tests.

All end-to-end tests must use the Cypress E2E test framework.

All end-to-end test filenames must end with .cy.js, and end-to-end test files with filenames that end with -hidden.cy.js will not be visible to the student.

If you want to add files that your hidden tests use and hence are also not visible to the student, the names of these files must begin with hidden, e.g., hiddenFoo.json, hiddenFoo.csv, hidden-foo.ts, etc.

The package.json file may only be changed if you want to add third-party libraries to your assignment. All the current versions of the dependencies in package.json and package-lock.json must not be changed.

The other config files in the template repo must also not be changed, including the babel.config.js and cypress.config.js files.

GitHub Action & GitLab CI/CD

AssignmentOS uses either GitHub Actions or GitLab CI/CD (depending on whether you use with GitHub or GitLab) to run automated unit tests. We provide the following GitHub Action & GitLab CI/CD file for React Native assignments. Note that this file is added dynamically to the repo of each student taking your assignment, so please do not include it in your template repo. This file also cannot be changed.

GitHub Action .yml fileGitLab CI/CD .yml file
name: React Native CI

on: push

jobs:

  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3

      - name: Install dependencies
        run: npm install

      - name: Install Expo CLI
        run: npm i -g expo-cli

      - name: Check Cypress tests exist
        id: check_cypress_tests
        uses: andstor/file-existence-action@v1
        with:
          files: "cypress/e2e/"

      - name: Install and run Cypress tests
        uses: cypress-io/github-action@v4
        if: steps.check_cypress_tests.outputs.files_exists == 'true'
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          build: npm run build --if-present
          start: npm run web
          wait-on: 'http://localhost:19006'

Coming soon!

Last updated