Skip to content

First run hangs if IDE fails to download assets #2042

Open
@per1234

Description

@per1234

Describe the problem

On the first run after a fresh installation, Arduino IDE downloads some files from the Internet:

  • The builtin:serial-discovery pluggable discovery tool
  • The builtin:mdns-discovery pluggable discovery tool
  • The Library Manager index
  • The primary Boards Manager package index

🐛 If the download of these files is not possible due to lack of Internet access, or some other problem (e.g., #2606), the startup hangs.

This is a change from Arduino IDE 1.x, which is in a fully functional state from the start with no hard dependency on an Internet connection (though obviously Library/Boards Manager can't be used).

To reproduce

  1. Select File > Quit from the Arduino IDE menus if it is running.
  2. Rename or delete (:warning: cautiously) the following folder to effectively simulate the environment of a first run:
    • If you are using Windows:
      C:\Users\<username>\AppData\Local\Arduino15
      
      (where <username> is your Windows username)
    • If you are using Linux:
      ~/.arduino15
      
    • If you are using macOS:
      ~/Library/Arduino15
      
  3. Disconnect your computer from the Internet.
  4. Start Arduino IDE.

🐛 Startup hangs at the startup animation.

🐛 The cause of the hang is not communicated to the user.

Expected behavior

Complete startup even when the essential resources could not be installed.

This is important because, once it has started up, Arduino IDE shows notifications that communicate the Internet access dependency to the user.

  • Record whether the arduino:avr and "Arduino_BuiltIn" installations were successful, and if not then retry on subsequent startups.
    • Note: This must be done based on a dedicated record, and not on the presence/absence of these installations because users may have later removed unwanted installations after they were successfully installed automatically.

Arduino IDE version

097c92d

Operating system

Windows

Operating system version

11

Additional context

The regression was introduced at a36524e


The logs include this:

2023-05-03T23:57:19.823Z root ERROR Uncaught Exception: 
2023-05-03T23:57:19.823Z root ERROR Error: The index of the cores and libraries must be updated before initializing the core gRPC client.
The following problems were detected during the gRPC client initialization:
[platform-index] - code: 9, message: Loading index file: loading json index file C:\Users\per\AppData\Local\Arduino15\package_index.json: open C:\Users\per\AppData\Local\Arduino15\package_index.json: The system cannot find the file specified.
[platform-index] - code: 9, message: Error loading hardware platform: discovery builtin:serial-discovery not found
[platform-index] - code: 9, message: Error loading hardware platform: discovery builtin:mdns-discovery not found
[library-index] - code: 9, message: Loading index file: reading library_index.json: open C:\Users\per\AppData\Local\Arduino15\library_index.json: The system cannot find the file specified.

    at isIndexUpdateRequiredBeforeInit (C:\arduino-tools\193-097c92d\resources\app\node_modules\arduino-ide-extension\lib\node\core-client-provider.js:388:11)
    at CoreClientProvider.evaluateErrorStatus (C:\arduino-tools\193-097c92d\resources\app\node_modules\arduino-ide-extension\lib\node\core-client-provider.js:200:16)
    at processTicksAndRejections (node:internal/process/task_queues:96:5)
    at async ClientReadableStreamImpl.<anonymous> (C:\arduino-tools\193-097c92d\resources\app\node_modules\arduino-ide-extension\lib\node\core-client-provider.js:184:31)

Related

Additional reports:

Issue checklist

  • I searched for previous reports in the issue tracker
  • I verified the problem still occurs when using the latest nightly build
  • My report contains all necessary details

Metadata

Metadata

Assignees

No one assigned

    Labels

    topic: codeRelated to content of the project itselftype: imperfectionPerceived defect in any part of project

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions