Skip to content

Commit

Permalink
Update known issues for WPILib 2024.2.1 (#2549)
Browse files Browse the repository at this point in the history
Add AdvantageScope overwrite issue to known issues and install
instructions.
Move unresolved dependency to fixed in 2024.2.1
Fix typo
Update wpilibrelease
  • Loading branch information
sciencewhiz committed Jan 22, 2024
1 parent f8c8d59 commit f4d4573
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 25 deletions.
57 changes: 33 additions & 24 deletions source/docs/yearly-overview/known-issues.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,13 @@ This article details known issues (and workarounds) for FRC\ |reg| Control Syste
Open Issues
-----------

AdvantageScope isn't updated by WPILib Installer on macOS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

**Issue:** When running the WPILib Installer, a pop-up saying ``"WPILibInstaller" was prevented from modifying apps on your Mac.`` and AdvantageScope remains version 3.0.1. This issue occurs when upgrading WPILib, when a beta version of WPIlib or WPILib 2024.1.1 was installed on macOS.

**Workaround:** Delete AdvantageScope from ``~/wpilib/tools`` and re-run the WPILib Installer.

Driver Station randomly disabled
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Expand Down Expand Up @@ -35,30 +42,7 @@ Driver Station internal issue with print error and tags

**Issue:** The Driver Station will occasionally print ``internal issue with print error and tags``. The message is caused when the DS reports a message on its side intermixed with messages from the robot; it is not caused by and does not affect robot code.

**Workaround:** Thie will be fixed in the next Game Tools release. There is no known workaround.

Visual Studio Code Reports Unresolved Dependency
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

**Issue:** Java programs will report ``Unresolved dependency: org.junit.platform junit-platform-launcherJava(0)`` on build.gradle. Programs that use unit tests will fail to build. This causes build.gradle to be highlighted red in the Visual Studio Code explorer, and the ``plugins`` line in build.gradle to have a red squiggle.

**Workaround:** This can be safetly ignored if you aren't running unit tests. To fix it, do the following:

On Windows execute the following in powershell:

.. code-block:: powershell
Invoke-WebRequest -Uri https://repo.maven.apache.org/maven2/org/junit/jupiter/junit-jupiter/5.10.1/junit-jupiter-5.10.1.module -OutFile C:\Users\Public\wpilib\2024\maven\org\junit\jupiter\junit-jupiter\5.10.1\junit-jupiter-5.10.1.module
Invoke-WebRequest -Uri https://repo.maven.apache.org/maven2/org/junit/junit-bom/5.10.1/junit-bom-5.10.1.module -OutFile C:\Users\Public\wpilib\2024\maven\org\junit\junit-bom\5.10.1\junit-bom-5.10.1.module
On Linux/macOS execute the following:

.. code-block:: sh
curl https://repo.maven.apache.org/maven2/org/junit/jupiter/junit-jupiter/5.10.1/junit-jupiter-5.10.1.module -o ~/wpilib/2024/maven/org/junit/jupiter/junit-jupiter/5.10.1/junit-jupiter-5.10.1.module
curl https://repo.maven.apache.org/maven2/org/junit/junit-bom/5.10.1/junit-bom-5.10.1.module -o ~/wpilib/2024/maven/org/junit/junit-bom/5.10.1/junit-bom-5.10.1.module
After running those, you’ll need to refresh Java intellisense in VS Code for it to pick up the new files. You can do so by running the ``Clean Java Language Server Workspace`` command in VS Code.
**Workaround:** This will be fixed in the next Game Tools release. There is no known workaround.

Driver Station Reports Less Free RAM then is Available
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Expand Down Expand Up @@ -169,3 +153,28 @@ Issues with WPILib Dashboards and Simulation on Windows N Editions

**Solution:** Install the `Media Feature Pack <https://www.microsoft.com/en-us/software-download/mediafeaturepack>`__

Fixed in WPILib 2024.2.1
------------------------

Visual Studio Code Reports Unresolved Dependency
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

**Issue:** Java programs will report ``Unresolved dependency: org.junit.platform junit-platform-launcherJava(0)`` on build.gradle. Programs that use unit tests will fail to build. This causes build.gradle to be highlighted red in the Visual Studio Code explorer, and the ``plugins`` line in build.gradle to have a red squiggle.

**Workaround:** This can be safetly ignored if you aren't running unit tests. To fix it, do the following:

On Windows execute the following in powershell:

.. code-block:: powershell
Invoke-WebRequest -Uri https://repo.maven.apache.org/maven2/org/junit/jupiter/junit-jupiter/5.10.1/junit-jupiter-5.10.1.module -OutFile C:\Users\Public\wpilib\2024\maven\org\junit\jupiter\junit-jupiter\5.10.1\junit-jupiter-5.10.1.module
Invoke-WebRequest -Uri https://repo.maven.apache.org/maven2/org/junit/junit-bom/5.10.1/junit-bom-5.10.1.module -OutFile C:\Users\Public\wpilib\2024\maven\org\junit\junit-bom\5.10.1\junit-bom-5.10.1.module
On Linux/macOS execute the following:

.. code-block:: sh
curl https://repo.maven.apache.org/maven2/org/junit/jupiter/junit-jupiter/5.10.1/junit-jupiter-5.10.1.module -o ~/wpilib/2024/maven/org/junit/jupiter/junit-jupiter/5.10.1/junit-jupiter-5.10.1.module
curl https://repo.maven.apache.org/maven2/org/junit/junit-bom/5.10.1/junit-bom-5.10.1.module -o ~/wpilib/2024/maven/org/junit/junit-bom/5.10.1/junit-bom-5.10.1.module
After running those, you’ll need to refresh Java intellisense in VS Code for it to pick up the new files. You can do so by running the ``Clean Java Language Server Workspace`` command in VS Code.
4 changes: 3 additions & 1 deletion source/docs/zero-to-robot/step-2/wpilib-setup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ WPILib is designed to install to different folders for different years, so that
Downloading
-----------

.. wpilibrelease:: v2024.1.1
.. wpilibrelease:: v2024.2.1

`You can download the latest release of the installer from GitHub <https://github.com/wpilibsuite/allwpilib/releases/latest/>`__.

Expand Down Expand Up @@ -60,6 +60,8 @@ When you download the WPILib installer, it is distributed as a disk image file `

For this release, macOS users will need to have the Xcode Command Line Tools installed before running the installer; we are working on removing this requirement in a future release. This can be done by running ``xcode-select --install`` in the Terminal.

.. important:: When upgrading from a 2024 beta release or 2024.1.1, it's necessary to manually delete AdvantageScope before running the installer. Navigate to ``~/wpilib/2024/tools`` and delete AdvantageScope.

macOS users can double click on the downloaded ``DMG`` and then select ``WPILibInstaller`` to launch the application.

.. image:: images/wpilib-setup/macos-launch.png
Expand Down

0 comments on commit f4d4573

Please sign in to comment.