Sign Up

Actor Framework 2024 for 2020 by justACS - Toolkit for LabVIEW Download

Actor Framework reorganized for improved PPL builds.

D Discussion Watch * 1 ↓0
 logo
Version2.0.0.18
ReleasedApr 23, 2025
Publisher justACS
License MIT
LabVIEW VersionLabVIEW>=20.0
Operating System Windows, Mac, and Linux
Project links Repository   Discussion

Description

This product updates the core Actor Framework libraries that ship with LabVIEW - Actor Framework.lvlib and AF Debug.lvlib.

The versions of these libraries that ship with LabVIEW 2024 Q3 have been backported for use with LabVIEW 2020 or later. If you are working in one of these earlier versions, you can now take advantage of Uninit.vi, a new dynamic dispatch member of Actor.lvclass, plus a small number of minor bug fixes.

In addition, this version contains a major reorganization of the Actor Framework core libraries to facilitate PPL builds, with minimal changes to functionality. Developers should be able to seamlessly update to this version of the framework, and then leverage its features and changes at their convenience.

Finally, we have added a protected method to Actor.lvclass that sends a Normal Stop to its nested autostop actors, and we have added a few productivity and test support items to the palettes. Please see the Release Notes for details.

As a pre-install action, this package will archive your existing core libraries and palettes. Should you wish to uninstall this package, your original libraries will be restored. The archive is stored in a filed called AF.zip, which you can find in vi.lib. Please do not delete this file, as you will lose the ability to restore the original files.

This version DOES NOT update the Actor Framework project providers. Updated project providers will be made available in a separate package, with its own update cadence.

Release Notes

2.0.0.18 (Apr 23, 2025)

1. Almost all of the contents of AF Debug.lvlib have been moved into Actor Framework.lvlib. AF Debug.lvlib now only contains the code that sends traces to Desktop Execution Trace Toolkit and a few compatibility remnants. DETT trace code is now encapsulated in a class (DETT Format.lvclass) that inherits from an interface (Trace Format.lvlcass) that resides in Actor Framework.lvlib.

2. Generate Trace.vi now dynamically loads a trace format. If no trace format is specified, Generate Trace.vi will load DETT Format.lvclass as the default. If users add the token AFDebugTraceFormat to their LabVIEW INI file, Generate Trace.vi will load that format instead. AFDebugTraceFormat is a path saved as a string.

3. Actor registration has been streamlined; Actor.vi no longer has to send Register Actor Msg.lvclass to the new actor to complete registration. Registration is performed directly in Actor Core.vi, just before message handling starts.

4. Stop Autostop Nested Actors.vi has been added. Use this protected method to stop all of your autostop nested actors without stopping the actor.

5. Items have been added to a new subpalette to support automated testing of your actors. These include the original Launch Actor.vi, Init Actor Queues FOR TESTING ONLY.vi, and a new VI, Test Launch for Nested Actor Without Caller.vi, useful for testing actors that run and then shut themselves down.

6. Enqueuer and Last Ack controls and constants have been added to the Functions and Controls palettes.

7. To improve the PPL build experience, the specialty messages (Batch, Reply, Report Error, and Self-Addressed) have been copied to new locations on disk, and the copies moved into libraries. The copies of Report Error Msg and Self-Addressed Msg are now part of Actor Framework.lvlib. The copies of Batch Msg and Reply Msg are members of a new library, AF Specialty Messages.lvlib. To avoid breaking existing code, the original versions of these messages remain on disk, but are now DEPRECATED, and marked accordingly. Developers are encouraged to migrate to the new library versions of these messages at their earliest convenience.

justacs was a contributor to this release


Download Package

Versions
All Contributors

  Post an Idea   Post a Resource

Recent Posts