Releases: macadmins/nudge
Nudge 2.0.12.81807
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Fixed
- When cached SOFA feed is malformed, attempt to retry downloading and invalidate for future Nudge runs
Changes
Nudge 2.0.11.81805
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Changed
- German localization improvements
- Thanks to northalpha Mirko Steinbrecher and for the changes!
- 648
- SOFA SLA Logging improvements
- Thanks to Eric Holtam for the changes!
- 647
Changes
- 74ee4e2 - Update Localizable.xcstrings
- c8a2ff3 - Added logging to show which case is detected and what value is being used to extend requiredInstallationDate for easier troubleshooting.
- 8497853 - Fix Typo
- ac23b5b - Merge pull request #648 from northalpha/enhance-de-locals
- babfc5a - Merge pull request #647 from poundbangbash/moar-logging
- 726804a - v2.0.11
Nudge 2.0.10.81799
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Fixed
- When using
latest
orlatest-supported
, under active exploitation minor updates were not correctly assessed, resulting in SLA extensions defaulting to the90
day SLA default value
Changes
Nudge 2.0.9.81796
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Fixed
- When using
latest
orlatest-supported
, major upgrades were not correctly assessed, resulting in SLA extensions defaulting to the90
day SLA default value
Changed
- Additional Japenese localization changes
Changes
- f768985 - update japanase text
- 970bef7 - fix japanese text
- 787fea6 - Merge branch 'main' into optimization-japanase-text
- 269e807 - Merge pull request #642 from enpipi/optimization-japanase-text
- 2e5c7eb - correct SLA computation for major upgrades
- 6c6a948 - v2.0.9
- 21fa025 - Merge pull request #643 from macadmins/development
Nudge 2.0.8.81789
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Changed
- Japenese Localization
- The
Debug
schema no longer honorsrandomDelay
Fixed
- The left side of Nudge is no longer cut off when using more "verbose" languages
- The left side of Nudge now has proper localization for the values
True
andFalse
Changes
Nudge 2.0.7.81783
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Added
- If using
utilizeSOFAFeed
, you can now set theaboutUpdateURL
tosofa
- If a URL is found in the relevant
SecurityInfo
key for the corresponding update, this value will be used. - If no URL is found, the aboutUpdateURL button will not be shown to the user
- Feature Request 629
- If a URL is found in the relevant
Changed
- The
SMAppService
logic logs have been moved to debug logs - When an updated Managed Preference is sent for
com.github.macadmins.Nudge
, if the values are different, Nudge will exit- This is a workaround for issue 602
- The LaunchAgent will ensure the application is successfully restarted at a future time.
Fixed
- The Jamf JSON schema file had an item missing and a key incorrectly set
Changes
- 7ddc361 - remove debug print
- 740d78a - Add 'disableNudgeForStandardInstalls' to Jamf schema
- 56191aa - Update com.github.macadmins.Nudge.json
- b620927 - Update com.github.macadmins.Nudge.json
- e19f199 - add debugging for SMAppService if/when it ever works
- f13a697 - Quit nudge when MDM profile is updated
- a42f3cb - redo SMAppService log method
- 2b43ba4 - v2.0.7
- 0172835 - allow dynamic sofa aboutUpdateURLs
- 9014f1d - Merge pull request #635 from macadmins/development
Nudge 2.0.6.81773
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Added
- Device within the
nudgeMinorUpdateEventLaunchDelay
now show current and delayed date- These logs also now show in the default Nudge logs when use the
logger
LaunchDaemon - Addresses 625
- These logs also now show in the default Nudge logs when use the
Changed
- Some logs have been changed from
info
toerror
,warning
ornotice
to give admins more visibility into Nudge behaviors - The
board-id
property has been moved to adebug
log event- Works around reports like 623
Fixed
- The
unsupportedURL
key was not being honored when clicking on the Unsupported UI button- Addresses 626
- Intel Virtual Machines now have a forced
board-id
property that complies with Apple's own logic/SOFA.- Thanks to Mykola Grymalyuk for the PR
- Addresses 621
requiredInstallationDisplayFormat
was no longer being honored on Nudge versions 2.0.1 through 2.0.5 due to a regression- Addresses 627
Changes
- 88886e0 - fix jamf json schema value
- 34a7e7f - Update README.md to mention 2.0
- 5006e8e - Utils.swift: Add handling for Intel Virtual Machines
- dec3f0f - fix unsupportedURL button action
- 7242bbc - move board-id to a debug log event
- f5327bf - Update changelog with some more info from PRs
- 713dac3 - redo VM logic names
- 5d9cb62 - bump to 14.5 for schema tests
- f5b7a43 - better log updateEventLaunchDelay
- 019650d - change some more logs
- 0ce8087 - go back and add another note about nudge 2.0 change
- bbcbe28 - bump to 2.0.6
- f2b9bfc - do not use locale if set to a different value
Nudge 2.0.5.81760
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Added
- To artificially change the
requredInstallationDate
to honor a previous macOS minor version, setminorVersionRecalculationThreshold
underosVersionRequirement
in amount of minor versions.- Ex:
minorVersionRecalculationThreshold
is set to 1 and SOFA feed has macOS 14.5 available- macOS device is 14.0: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
- macOS device is 14.1: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
- macOS device is 14.2: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
- macOS device is 14.3: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
- macOS device is 14.4: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
- macOS device is 14.4.1: Required OS: 14.5 - Target macOS 14.5 requiredInstallationDate of 2024-06-03 00:00:00 +0000
- This device's requiredInstallationDate is different than the others as there is no active exploit on 14.4.1
- macOS device is 14.5: Required OS: 14.5 - Fully updated
- Ex:
minorVersionRecalculationThreshold
is set to 2 and SOFA feed has macOS 14.5 available- macOS device is 14.0: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-03-21 00:00:00 +0000
- macOS device is 14.1: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-03-21 00:00:00 +0000
- macOS device is 14.2: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-03-21 00:00:00 +0000
- macOS device is 14.3: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-03-21 00:00:00 +0000
- macOS device is 14.4: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-04-08 00:00:00 +0000
- macOS device is 14.4.1: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-06-03 00:00:00 +0000
- macOS device is 14.5: Required OS: 14.5 - Fully updated
- Ex:
minorVersionRecalculationThreshold
is set to 3 and SOFA feed has macOS 14.5 available- macOS device is 14.0: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-02-22 00:00:00 +0000
- macOS device is 14.1: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-02-22 00:00:00 +0000
- macOS device is 14.2: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-02-22 00:00:00 +0000
- macOS device is 14.3: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-02-22 00:00:00 +0000
- macOS device is 14.4: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-04-08 00:00:00 +0000
- macOS device is 14.4.1: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-06-03 00:00:00 +0000
- macOS device is 14.5: Required OS: 14.5 - Fully updated
- Addresses 612
- Ex:
- To ease testing, you can now pass
-simulate-date
as an argument to override the built-in date check.- Ex:
-simulate-date "2024-07-25T00:00:00Z"
- Ex:
Changed
- The
Actively Exploited
logic internally within Nudge and the UI on the left sidebar will showTrue
if any previous updates missing on the device had active exploits.- WARNING BREAKING CHANGE - This changes the SLA computation and will result in a different
requiredInstallationDate
than offered in Nudge v2.0 -> v2.01. - Ex: Device is on 14.3 and needing to go to 14.5.
- While 14.4.1 -> 14.5 are not under active exploit, 14.4 contains fixes for 14.3 that were under active exploit.
- Addresses 610 and 613
- WARNING BREAKING CHANGE - This changes the SLA computation and will result in a different
- When
showRequiredDate
is set toTrue
and the admin is using the default values forrequiredInstallationDisplayFormat
, Nudge will attempt to understand the current locale and display the menu item appropriately.- Addresses 615
- Banned shortcut keys - including the ability to quit the application - are now allowed when passing
-simulate-os-version
or-simulate-hardware-id
or-simulate-date
Fixed
- Several components in the Github Actions were triggering deprecation warnings. These have been addressed by updating to the latest version of these components
- Addresses 616
Changes
- 3ad843d - redo under active exploit logic
- c38d799 - add another note in the changelog
- ccc1d29 - bump to v2.0.5
- 84fb165 - attempt to show locale when using default values for showRequiredDate
- 930681f - address deprecated github actions
- 0d53821 - Add logic for minorVersionRecalculationThreshold
- 07452c3 - re-order logs
- 1fd7e94 - fix some logic issues and add safety
- abfccf7 - fix changelog
- 5d5d6a1 - add an additional note as to why the date is different
- 69421f4 - ensure active exploit logic is properly assessed
- 3d618e9 - add additional logging for computation
- 2f39c0c - fix version comparison
- 500e317 - update changelog with new tests
- c208c8a - Merge pull request #614 from macadmins/development
- 394792c - Update CHANGELOG.md
- 62ba9b7 - Merge pull request #617 from macadmins/erikng-patch-1
- 8294e9d - redo the minorversion calculation a third time
- 06a4476 - allow banned keys when simulating versions
- c17e0db - fix typo
- 7038593 - allow simulated dates
- 4313964 - Merge pull request #618 from macadmins/development
Nudge 2.0.4.81737
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Fixed
- Logic introduced in v2.0.1 for
requiredInstallatonDate
when using the newgracePeriodInstallDelay
was still incorrect and has been rewritten a second time.- Unit tests were changed to match the fixed behavior
gracePeriodLogic
is now computed after the SOFA feed assessment
- Logic introduced in v2.0.2 accidentally forced the
randomDelay
when using the-demo-mode
argument. This is now removed. gracePeriodsPath
objects that were 0 bytes in size were ignored. This has been modified to allow these files- Ex: Ann admin simply runs
touch
on a file.
- Ex: Ann admin simply runs
- The JAMF JSON schema had an incorrect title value for
unsupportedURLs
- PRs sent to the Nudge repo will now have the tag
safe-to-test
removed after every CI/CD run, regardless of pass/fail status. - The PR build script has been fixed to re-upload zipped
Nudge.app
files for user testing
Changes
- c0c12e3 - cleanup nudge pr tag after every run
- 8773366 - fix changelog note
- 16f3276 - correct aboutUpdateURLs to unsupportedURLs (#609)
- 125b537 - re-assess gracePeriod logic with SOFA
- d95e6ac - maybe fix test
- 2671aa3 - always cleanup tag
- 32fa490 - redo build script for PRs
- 057106e - disable randomDelay when using -demo-mode
- 83876e7 - update changlog
- 3c17931 - bump date of 2.0.4
Nudge 2.0.3.81727
Notes
This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.
By default Nudge looks for a com.github.macadmins.Nudge.json
file located in /Library/Preferences
. If you would like to use an alternative path, please read the README or the WIKI
About the LaunchAgent
This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.
Changelog
Requires macOS 12.0 and higher.
Changed
- The command line argument
-disable-randomDelay
is now-disable-random-delay
Fixed
- When a user clicked on the
updateDevice
button, the logs would incorrectly state the user was entering the "Unsupported UI" workflow. - When running unit tests, Nudge no longer honors the randomDelay key or command line argument
Added
- To ease SOFA testing, you can now pass
-custom-sofa-feed-url
as an argument to override the built-in preferences and/or custom profile/json.- Ex:
-custom-sofa-feed-url "file:///Users/Shared/macos_data_feed.json"
- Ex:
Changes
- a77913b - bail on CI/CD if Apple's notary service is down
- 73656af - Better log event on Replace My Device action
- efb9ecc - add option for -custom-sofa-feed-url
- 766246a - fix updateDevice log events
- f9832a3 - v2.0.3 changelog
- e933595 - bump project to v2.0.3
- d9734a0 - ignore random delay for unit tests