⬆️From 0.1.0 Beta 2 to 0.1.0 Beta 3
Guide for upgrading 0.1.0 Beta 2 mods to 0.1.0 Beta 3
This page lists all the changes that have been made from 0.1.0 Beta 2 to 0.1.0 Beta 3. For upgrading your mods from 0.0.24.x directly to the 0.1.0 series, use the main upgrade page instead.
Migrated to ProvidedArgumentsInfo
ProvidedArgumentsInfoThe first class provided information about the command arguments. It held information about user input, and it indicated whether the user input was correct or not. It worked on the UESH shell and its sub-shells either implemented by ourselves or by a custom mod. The second class, ProvidedArgumentArgumentsInfo, did exactly the same thing, but with one difference: it worked with kernel arguments.
However, this was considered code repetition as 95% of the parts were repeated with differences in names, so we decided to refactor these two classes to a single ProvidedArgumentsInfo with the following public functions found in ArgumentsParser:
ParseShellCommandArguments()ParseArgumentArguments()
We advice you to replace all calls to Provided*ArgumentsInfo constructors and start using the Parse*Arguments() function found in ArgumentsParser, which does the very job of parsing commands and kernel arguments.
Migrated TUI apps' colors to TuiColors
TuiColorsWe used to provide users options to change each built-in TUI application's colors, like the file manager, the contacts manager, and the task manager. Sadly, we had to migrate all these configuration entries to a single configurable TUI color class, TuiColors.
Currently, there is no plan that proposes restoring this.
Moved KernelErrorLevel to Kernel.Exceptions
KernelErrorLevel to Kernel.ExceptionsKernelErrorLevel was used by the kernel panic module, a group of functions that get executed when there was a kernel error, depending on the severity of the error and the state of the kernel.
Looking at the structure, we saw that it was left alone in the process of migrating all kernel error-related to the Kernel.Exceptions namespace, so we decided to finish the merge process by relocating KernelErrorLevel to Kernel.Exceptions.
Although the KernelErrorLevel enumeration is public, the kernel error functions are internal, so we may remove visibility from the public API at some point during the Beta 3 development.
Aliases and usability problems
Aliases were first implemented as hard-coded aliases back on 0.0.1, but it got evolved into user-configurable aliases and went well with no problems.
However, what we haven't noticed during the custom shell type implementation is that the ShellType version of AddAlias() tends to repeat itself, causing the stack to overflow and Nitrocid KS to crash on every function that called it. This affected all the versions that implemented the custom shell types; all the way to 0.1.0 Beta 2.
However, we've noticed that the alias creation logic treats the source (a command that will be aliased to) as a target, and the target (an alias name) as a source, so we've decided to make some breaking changes to correct this confusion.
We can't document these APIs as a result of this confusion until we rewrite them with care. This re-write will reduce confusion between the source and the target, and ensure that aliases are added properly and that the tests are reporting success.
Screensaver probing changed
Screensavers used to be found in their own path, called KSScreensavers, usually found in your user's local app data folder. However, this was implemented at a time that mods were still one-line C# and Visual Basic code files and didn't support dependencies.
When we started improving the mod parsing code, we've made these improvements starting from a version that implemented kernel modding until now, and these improvements were still getting committed.
This caused us to ditch the following features:
Custom screensaver settings, as they have never been tested with the latest version of Nitrocid. The only time that we've tested this feature was when we were implementing this feature, and that was a long time ago.
Custom screensaver parser that worked exactly like mod parsing code was removed and replaced with the register and unregister logics, since they were better in various degrees. This was done as a result of recent improvements to the modding system.
CustomSaverInfowas removed, as none of its properties, except the base screensaver, looked like it had any use anywhere in the entire screensaver management and kernel mod management functions.ReloadSaverwas removed from the list of available commands as a result of this breaking change. You can now use the kernel mod manager to load an updated version of any mod, which may register screensavers on boot.Paths to custom screensaver and its settings were removed from the available kernel path list as a result of all the above removals.
In order to be able to use a screensaver provided by your mods, they must now call the following functions from CustomSaverTools:
When the mod starts up (
StartMod()), they must call theRegisterCustomScreensaver()function, pointing it to your new instance of your base screensaver class.When the mod shuts down (
StopMod()), they must call theUnregisterCustomScreensaver()function, pointing it to the name of the screensaver that you want to unregister.
You can check to see if your screensaver is initialized by calling the IsScreensaverRegistered() function.
Screensaver management class renamed
When we first implemented the screensavers, we used to call the class that was responsible for the management of the screensavers, Screensaver. However, it was done when Visual Basic was the dominant language for the whole simulator.
As a result of merging to C# on Milestone 2 of 0.1.0, we've decided to make final migration changes by renaming the screensaver management class to ScreensaverManager.
We recommend that you change all references to ScreensaverManager when migrating from 0.1.0 Beta 2 or lower.
SSH class renamed
When we first implemented the SSH shell, we used to call the class that was responsible for launching the SSH shell, SSH. However, it was done when Visual Basic was the dominant language for the whole simulator.
As a result of merging to C# on Milestone 2 of 0.1.0, we've decided to make final migration changes by renaming this class to SSHTools.
We recommend that you change all references to SSHTools when migrating from 0.1.0 Beta 2 or lower.
Speed Dials and Network Connections
When network connections were introduced in Beta 2, we didn't have an opportunity to make speed dials interact properly with network connections.
After Beta 2 was released, we finally took action to remove SpeedDialType so that NetworkConnectionType can be used instead. As a result, QuickConnect() functions in the FTP and SFTP tools code were gone and AddEntryToSpeedDial() and its Try function had its speed dial type argument replaced with NetworkConnectionType.
Replace all calls to SpeedDialType with NetworkConnectionType. For custom network connection types, you can use new overloads of the two Add functions, which take a string representation of your custom network connection type.
Handling multiple CommandArgumentInfo instances
CommandArgumentInfo instancesTo add support for multiple CommandArgumentInfo instances in one CommandInfo or ArgumentInfo, we now had to replace all single CommandArgumentInfo parameters in the above constructors with an array argument of the same class.
This resulted in us having to adjust the entire shell system to adapt to this kind of change.
Your mods must now follow the new pattern of how to define new CommandInfo instances in the Commands property in your shell class, provided that you've committed the below changes. The page below explains in depth about how to define these instances.
The following parameters were changed:
CommandInfoBefore:
CommandArgumentInfo CommandArgumentInfoAfter:
CommandArgumentInfo[] CommandArgumentInfo
ArgumentInfoBefore:
CommandArgumentInfo ArgArgumentInfoAfter:
CommandArgumentInfo[] ArgArgumentInfo
Screensaver displayer class is no longer public
ScreensaverDisplayer was created as a way to show screensavers efficiently when called with ShowSavers(). Upon further inspection, DisplayScreensaver() behaves exactly the same as the ShowSavers() function, but with more relaxed flagging and checking.
This function was used as a thread handler, but it looks like that it can be called from any mod, so we decided to demote the class and the method shown above so that mods can't use them.
It's recommended to cease using the above class and start using ShowSavers() as the only suitable alternative.
Error codes and -set unified switch
-set unified switchInitially, on Beta 2, it had a very basic error code support that set a UESH variable called UESHErrorCode. It didn't support errors which came from the commands itself; only from the command processor, GetLine().
However, we decided to implement the following features:
Improved error codes: UESH scripts can now rely on error codes more reliably, because error codes can now be get straight from the base command implementation,
Execute()to be specific.-set unified switch: For commands that set their output to a specific UESH variable, this switch will set that variable to the generated output, provided that the command already sets the output value, which is
ref string variableValue.
As a result, this massive breaking change had to be done in order to implement the two abovementioned features.
Please note that there are no built-in commands which make use of the second feature, but your mods could implement them in their own commands.
Your mods and its commands, however, will have to adapt to the first feature by changing the signature shown at the top of this section to the below signature:
Moved notification priority and type enumerations
We've moved the two above enumerations, NotifPriority and NotifType, and renamed them to their extended names in their own code files. This is to make referencing both of them easier when creating notification instances and managing them.
You no longer have to reference NotificationManager before one of the two above enumerations. However, you'll have to retry referencing them under the new names:
NotifPriority->NotificationPriorityNotifType->NotificationType
Commands that don't accept -set
-setWe've implemented -set as a unified switch to set the variable to the value of the command output generated by the command class. However, there are commands that don't use this feature, hence we no longer accept their usage of -set unless absolutely necessary.
You need to take the following cases into account:
If your command doesn't use the custom completion and your command doesn't use the
-setswitch, there is no action to be taken.If your command doesn't use the custom completion, but your command uses the
-setswitch, you must set theAcceptsSetparameter totrue.If your command uses the custom completion, you may specify whether the command accepts or declines the
-setswitch, but you must enter this value before the command completion argument. The signature will help illustrate this:
Used SemanVer on KernelUpdate
KernelUpdateAs SemanVer was released to the public, we decided to release a new version of SemanVer handling SemVer 2.0-compliant versions that also follow the four-part versioning so that Nitrocid KS can accurately check for updates.
As a result, we no longer have to deal with conflicts, like debates about 0.1.0 Beta 1 being the "final" version for 0.0.24.x or lower, which is going to take effect on these series' Backport Fridays.
We advice you to adjust your usage of UpdateVersion so that it is suitable with the SemVer class.
Removed KernelUpdateInfo
KernelUpdateInfoThe kernel updater used to host two classes:
KernelUpdateto fetch the updates and install relevant information to the class, like the version and the update link, andKernelUpdateInfoto host these two again.
However, KernelUpdateInfo was proving its redundancy regarding its functionality, so we've removed it.
We advice you to use KernelUpdate instead of KernelUpdateInfo.
Added FileSystemEntry
FileSystemEntryWe used to rely on FileSystemInfo to get basic information about any file or folder. However, we needed to extend this class to include more functions to it, so we've implemented FileSystemEntry.
As a result, we've replaced every FileSystemInfo instances with FileSystemEntry. You can still access this instance through the BaseEntry property.
We suggest that you change how you call the above functions so that you can use an instance of FileSystemEntry. You can create an instance of it using the constructor.
New way of getting a list of themes
We used to resort to using the above field to get a list of available themes and getting an instance of the selected theme. However, the current approach was reachable to all the kernel mods and can be manipulated with.
Also, we didn't want to add a single theme to three different places, so we decided to just let the kernel populate the themes itself by splitting one massive resources file into three different resource files:
LanguagesResources
SettingsResources
ThemesResources
We then make the above field private, but you can get a copy of it using the GetInstalledThemes() function. We've also changed the resource name of the default theme from _Default to Default as we're no longer in the Visual Basic land.
You can get a list of themes using this function, which has the below signature:
Added themes support for interactive TUI colors
When migration of interactive TUI colors was done, the end result was that InteractiveTuiColors was made to store all the interactive TUI colors for each element, like the pane background color, selected pane box border color, and so on.
However, we needed to reduce the number of reboots to set these colors, so we decided to remove this class, add these colors to the kernel color type enumeration, and update all themes to use this new feature.
This caused the interactive TUI to maintain color consistency with the rest of the Nitrocid colors.
You usually don't have to do anything. You can still access these base colors using the Config.MainConfig class. No names are changed.
Added connection options from speed dial
The network connections didn't support speed dial options, so we decided to add support for it. As a consequence, we've had to change its signature so that it would hold both the normal connection establisher and the speed-dial-based connection establisher.
You must adjust your calls to the two above functions so that they also hold the speed-dial-based connection establisher, as indicated in the signatures below:
Changed how event handler registration works
InitEvents can be huge because there are too many event types to handle, so we decided to go the easier and the cleaner way and switch the handler from InitEvents() to the delegate-based handler.
We recommend merging away from InitEvents() to use both of the register and unregister functions that are outlined below.
Although your mod can contain the InitEvents() code because Nitrocid doesn't error out, we still advice you to follow the recommendation for your event handler code to continue working, as well as storing a list of event handlers (at least a List<Action<object[]>>) to be able to register and unregister them.
Removed "background trigger"
This feature was implemented in the early stages of development for the API 3.0 kernel series. However, this wasn't tested for a long time ever since Milestone X was out, so we decided to remove this configuration.
As a result, we've removed the Force and the ForceSet variables.
We advice you to cease using this function.
Custom command addition changed
Nitrocid used to use the Commands dictionary to register all of the commands during the mod startup. However, this was found to be unnecessary because StartMod() was also an entry point code for each mod. Also, this breaking change was made with respect to the recent UESH shell improvements regarding the command handling logic.
So, we decided to remove this key from the interface, making it redundant for general purposes. However, you may choose to keep the Commands list, given that you're going to use the command registration functions added with this change and that the commands in the CommandInfo instances are the same as the command dictionary keys.
Historically, the Commands list was originated when there was no meaningful way to customize the shell and when the command handler was not using the base command classes for each of them.
The below link shows how to use the register/unregister functions.
🐚Shell StructureMods that expect commands to be added automatically must now use the RegisterCustomCommand* functions on mod start and UnregisterCustomCommand* functions on mod shutdown. This allows you to dynamically add commands to the shells without affecting the base shell command list.
However, if you want a simple migration way, don't remove the Commands dictionary as it's unused; just use it to get its keys (strings) and values (CommandInfo instances) to use UnregisterCustomCommands() and RegisterCustomCommands() in the shutdown (StopMod()) and the startup code (StartMod()), respectively.
Added theme addons
The above ThemeInfo constructor was made obsolete due to all the themes migrating to the theme addons. This was done to try to reduce the overall size of the main Nitrocid binary.
We recommend that you use the output of the GetInstalledThemes() function and query a theme info instance from the theme name instead.
Improved the query API for text editor
The query API for the text editor has been simplified as a result of having simpler ways of expressing the results. This was also done, because we needed to highlight the results found using one of the query commands in the text editor.
The signatures have been changed. You can refer to the API documentation for the updated information.
Aliases reworked
The aliases system was a mess since a long ago, because it was first implemented using a single CSV file containing information about aliased commands.
We realized how this was going to affect its maintainability, so we decided to refresh it by switching to a JSON-based serialization and deserialization method, eliminating the 3 above functions.
With regards to PurgeAliases(), once any alias is removed, they're automatically purged.
With regards to DoesAliasExistLocal(), you can substitute calls to that function with the DoesAliasExist(), making changes as necessary.
Added the signing key (a.k.a. strong name)
Nitrocid KS launched without any signing key. Originally, it was planned to come signed by us, but it didn't work. However, we used the strong naming tool to give Nitrocid KS a unique identity to avoid dependency hell.
It's not necessary to strong name your mods, but we recommend you to do so using the strong naming utility (sn.exe) that comes with Visual Studio.
Most of the time, you don't have to do anything to your mods, since the signing key change doesn't break any API functions. If you found that your mods no longer worked, try to update to the latest version of Nitrocid, or contact the mod vendor.
Interactive TUI is now part of ConsoleBase
ConsoleBaseThe interactive TUI started off as part of the Misc namespace found under KS. However, it became almost stable and ready for the prime time, so we decided to move it to ConsoleBase in preparation for the upcoming release of Terminaux, which brings performance-related improvements.
Because this is a namespace move, you'll have to update the imports that point to the above namespace to point to the new namespace below:
Used Figletize
This change also applies to FigletColor and FigletWhereColor.
Figgle didn't see any recent development for a long time, so we decided to tweak it a bit in our own fork, Figletize, prior to releasing it as version 0.6.0.
We decided to take out legacy support in both Nitrocid KS and Terminaux as Figgle wasn't signed using a signing key.
You must migrate from Figgle to Figletize in order to be able to use the new functions. The signatures are the same, but using the FigletizeFont instance instead of FiggleFont.
Terminaux's documentation will cover the ways of migration.
Added CommandArgumentPart
CommandArgumentPartCommandArgumentInfo used to use strings and few support variables for arguments. However, there are cases where mods need more control over the argument parts, especially the auto completion part.
CommandArgumentPart is made for this purpose, so we've changed the above constructors in CommandArgumentInfo to be able to specify arguments using the brand new class.
You must change all CommandArgumentInfo instance creation to satisfy this new format. For example, exec's CommandArgumentInfo is defined like this:
Remote debug configuration handler changes
The remote debug device handler has undergone significant changes related to how it handles remote device configuration, because we needed a less convoluted way of obtaining device properties and setting them, so we decided to make the following changes as stated in the comments of the above snippet.
As a result, custom remote debug command classes must now change the signature to match the below signature definition:
Speed dial configuration changes
The speed dial handler has undergone significant changes related to how it handles speed dial configuration, because we needed a less convoluted way of obtaining speed dial properties and setting them, so we decided to make the following changes as stated in the comments of the above snippet.
Because SpeedDialEntry is implemented, you need to use the new overloads and functions from the SpeedDialTools class when migrating from the old JToken approach.
Breaking changes caused by migration to addons
There are breaking changes that are caused by the migration of some of the optional kernel features to the addons system so that they don't bloat the base kernel up. The following applications are affected:
To-do list
Forecast
Contacts
Calendar
Archive Shell
Games and Amusements
Timers
Dictionary
Name generation
Unit conversion
Lyrics
Calculators
Theme and Language studios
Color conversion commands
Time information commands
Your mods will no longer be able to use their APIs, due to how these addons are isolated from the base kernel.
Removed Figgle-related tools and writers
Because Terminaux got updated in a way that it separated Figgle-related tools and writers from the Figletize-based implementation, we've decided to remove all Figgle-related tools and writers from the Nitrocid KS codebase.
You must migrate from Figgle to Figletize in order to be able to use the new functions. The signatures are the same, but using the FigletizeFont instance instead of FiggleFont.
Terminaux's documentation will cover the ways of migration.
Moved ShellManager to ShellBase.Shells
ShellManager to ShellBase.ShellsShellManager used to be found on a loose KS.Shell namespace. However, we needed to enforce better organization of the shell management code, so we moved this class to the ShellBase.Shells namespace inside KS.Shell.
None of the functions are affected by this change. However, you need to change the imports to point to the ShellBase.Shells namespace.
Moved Editors to Files
Editors to FilesThe following editors have been moved from Misc to Files as a result of their APIs being mature:
Hex editor
JSON shell
SQL editor
Text editor
This is to acknowledge that these editors are indeed part of the filesystem editing process.
None of the functions are affected, but you must change the namespace imports to the following:
Updated LocaleGen.Core namespaces
LocaleGen.Core namespacesLocaleGen.Core is a library that generates final translation files for each built-in and custom language for Nitrocid KS to be able to use.
To clear up the organization, we've decided to update the above namespace to match the library name.
The new namespace for the LocaleGen.Core functions is:
Promoted Settings to Kernel.Configuration
Kernel.ConfigurationInteractive settings was initially implemented as a Windows Forms application independent of the main application. It was moved to Nitrocid starting from 0.0.12.0.
The "Settings" application was meant to be a core part of the kernel, so we've moved all the Settings classes to the KS.Kernel.Configuration.Settings namespace.
None of the classes are affected, but you should update your namespace imports to the below namespace:
Corrected the name of Journaling enum entry
Journaling enum entryWhen kernel journaling was first released, it was initially implemented under the name of "Journalling," but we found out that it wasn't a correct spelling for the word.
We've decided to correct that by renaming the enumeration value and the property.
If you use any of the two affected objects mentioned above, change your references so that it says Journaling.
Moved presentation system to ConsoleBase
ConsoleBaseThe presentation system used to be found in the Misc section of the kernel. However, it has been moved to a completely different section as it has to do more with printing things to the console.
None of the classes are affected, but you should update your namespace imports to the below namespace:
Renamed Flags to KernelFlags
Flags to KernelFlagsIn order to maintain consistency for the naming scheme that we use for our base classes, we've renamed Flags to KernelFlags.
None of the flags are affected. However, the following changes are made:
Changed the class name to
KernelFlagsChanged the namespace to
KS.Kernel.Configuration
Moved argument and switch management
The KS.Shell.ShellBase.Commands namespace kept getting bigger with each new feature UESH receives from time to time, so we've decided to clear the confusion and move the above classes to their respective namespaces:
KS.Shell.ShellBase.SwitchesKS.Shell.ShellBase.CommandsKS.Shell.ShellBase.Arguments
None of the functions are affected, but you must adjust the namespace imports to the above namespaces.
HelpDefinition's setter is private
HelpDefinition's setter is privateWhen HelpDefinition was first implemented, its setter was open, under the assumption that mods can adjust their help definitions when they define their commands.
However, with the improved shell and its command handling code, especially the inception of CommandArgumentInfo and its siblings, we've decided to finally make the setter private.
You can no longer use the HelpDefinition property to directly set your command description. Instead, define your command description when making your own CommandInfo and its associated CommandArgumentInfo and SwitchInfo instances, if any.
Implemented original argument string and list
You only had a text of arguments and its list version, which were processed. However, we've considered cases where the unprocessed version might be more appropriate.
So, we've decided to implement the first two variables again, but, this time, the unprocessed version. That means no removal of any content in the text.
The signature for these two functions has changed. You must change your override to match the new signature, like below:
Moved parsers to the Text namespace
Text namespaceThese probers used to be loosely located on the Probers section of the Misc namespace. In order to improve organization, we've relocated these namespaces to the Text section of the Probers namespace.
These namespaces have been located to the new location. They can be respectively found on:
Remove leftover namespace, UserProperty
UserPropertyUserProperty was first implemented on 0.0.16.0 as a result of converting the users configuration file to the JSON format from the old CSV format known to have flaws.
Over time, it was populated with the following properties:
Username
Password
Admin
Anonymous
Disabled
Permissions
FullName
PreferredLanguage
Groups
However, we've made a third refinement to the login configuration logic, this time, using the JSON serialization and deserialization techniques to reduce the complexity.
As a result, UserProperty was rendered useless.
We advice you to cease using this enumeration. It's neccessary that you use more appropriate ways to get and set user properties to ensure that the mod code transition from Beta 2 or lower to Beta 3 goes smoothly.
Moved argument tools
We've moved the argument tools from ArgumentBase to reduce the complexity. Now, the argument tools are no longer one namespace level deep.
The argument tools are moved to the new namespace:
Removed UserProperty
UserPropertyUserProperty was first implemented as individual flags, into which were turned into this enum somewhere during the development of the most anticipated version, 0.0.16.0. However, it has become increasingly complex to the point that we've made major changes to the configuration reader and writer in two stages during the development of 0.1.0.
As a result, this enum was rendered useless.
We advice you to cease using this enumeration. Make appropriate changes with the functions that UserManagement provides.
Remote debugger provides WriteDebugDeviceOnly()
WriteDebugDeviceOnly()Because we've implemented RemoteDebugDeviceInfo and RemoteDebugDevice to simplify the process of getting a device information from the list of remote debug devices, we've provided you with a handy function that allows you to write to one debug device, WriteDebugDeviceOnly().
In consequence, we've had to change the Address parameter from RemoteDebugDeviceInfo to RemoteDebugDevice to allow easier access to this added function.
The Execute() function has been changed, so you have to change the signature so that it becomes:
PromptForSetLang() removed
PromptForSetLang() removedIn the language manager, PromptForSetLang() was used for prompting the user to set the language. However, it wasn't used since ChLang was removed several milestones back. ChLang was brought back much later, but without the usage of this function. As a result, we've removed this function.
It's advisable to cease using this function.
Moved custom screensaver tools
The customized screensaver tools have been moved to the screensaver management class, because we saw that there was absolutely no need for a specialized class for such tools. This allows easier access to the registration and unregistration functions.
You must change your reference to all the tools found inside the above class to the ScreensaverManager class if you're using one of these:
RegisterCustomScreensaver()UnregisterCustomScreensaver()
AutoCompleter only requires an array
AutoCompleter only requires an arrayPreviously, when we used the deprecated ReadLine.Reboot library to handle autocompletion, we used to pass in the three parameters. Now that Nitrocid KS's auto completion handler automatically chops the string to only return the completion of the argument (file name, user name, etc.), these three parameters are no longer needed.
If you're not using these three parameters, the transition is easy. However, if you are using one of them, you'll need to refactor your command info code so that it matches the requirements.
Added CommandParameters
CommandParametersThe base command's Execute function used to only host two parameters, which were the first two arguments in the above function. Since then, many things were added, like original argument string and list, variable setting, and list of switches.
This caused us to introduce the CommandParameters class to allow us to introduce further changes (further additions or improvements) without breaking the whole signature of the above function.
You must change all your command classes to have the below signatures:
Customizable settings entries
This breaking change is divided to the below parts, from the oldest to the newest:
Initial migration of settings entries
Currently, the maintenance of the settings application is complex, because the settings application contained three Open* functions that basically did everything.
We've decided to take the first steps by converting the settings entry list embedded JSON files to arrays of classes containing the entry information. Basically, it created two classes dedicated to that:
SettingsEntry: Represents a sectionSettingsKey: Represents a settings key with its options
Currently, it's not possible to use the above functions anymore with the built-in Nitrocid settings entries, because it relies on a private function that gives you the necessary infromation.
Initial support for custom settings
Custom settings are implemented to increase the flexibility of the kernel configuration so that your mods can now have their own settings entry list file. This means that your mods are now configurable in a way that Nitrocid's settings application can handle all your settings.
Finalization of the custom settings
The custom settings feature has been finalized to the point that it's reached the stable stage, so we've decided to move almost all the screensaver and splash entries (from their addons) from the base Nitrocid configuration entry JSON files to their appropriate entries.
Removed the ConfigType enumeration
ConfigType enumerationThis is the final part of the configuration system customizability. This change removes the ConfigType enumeration to increase consistency across the custom settings functionality, thus removing several of the above functions.
This configuration system overhaul is massive, so we recommend that you:
Stop using the removed functions,
Adjust your code to align with the new configuration system, and
Migrate your "custom settings app" for your mods (if implemented) to use Nitrocid's settings handler by registering and unregistering your settings classes as per guidance.
Help system refactors
The help system code has been moved to its own namespace, because it has nothing to do with command management or execution, although it displays the usage of the commands. This is to ensure consistent organization of the UESH shell portion of the simulated system, backed by the Nitrocid kernel.
This class has been moved to the HelpPrint class in the KS.Shell.ShellBase.Help namespace.
Moved several filesystem classes
Several of the filesystem classes were moved to more appropriate places so that we can ensure better organization related to the filesystem namespace.
All classes which were located on the Print namespace were mvoed to KS.Files.Operations.Printing.
Similarly, all querying classes, such as Checking and Parsing, were moved to KS.Files.Operations.Querying.
Also, the reading class name was changed to Reading and its namespace changed to KS.Files.Operations.
Additionally, the ReadToEndAndSeek() function was moved to the Reading class, causing the StreamRead class to be removed.
Conflicting write overloads reduced
Ever since Terminaux was released to the public, the Color class had an implicit operator which would take either an integer, a string, or a ConsoleColors value and create a new Color class based on these values. This caused us to have to fix every function call that contain strings as their first parameters, since they were mistaken for creating a new color, causing graphical artifacts.
We've recommended mod developers who suffer from this ambiguity issue append a vars: prefix in its appropriate place and write new object[] { args }, but this is a big overhead.
So, we've decided to rename function names that take colors to these variants:
Write(): for plain writing in default colorsWriteColor(): for writing with custom foreground colorsWriteColorBack(): for writing with custom foreground and background colorsWriteKernelColor(): for writing with kernel-defined color types
You no longer need to override the vars value using the above method. Instead, you can replace these calls with one of the above functions, based on the color type.
Moved hardware probe tools to the driver
The hardware prober used to be a wrapper for a single hardware specification library, Inxi.NET, that probed everything, including the RAM, the CPU, and the GPU. Over time, Inxi.NET faced lots of JSON management problems, including a recent change to the JSON output back on a version that was released between late 2020 and April 2021.
As a result, we're slowly migrating to the completely new hardware probing library that will be hopefully faster than Inxi.NET.
Unfortunately, full hardware probing has been removed.
ListHardware's behavior has changed so that it only gets information about supported hardware types.
New ThemeInfo by theme name removed
ThemeInfo by theme name removedEver since themes were moved to their own separate place, called Theme Packs, we've decided to remove this obsolete constructor, because it was rendered useless and can only search for the default theme.
Additionally, it can't handle addon themes, because Nitrocid isn't supposed to access other addon's resources, so we've decided to make a final decision to remove the above constructior.
We advice you not to use this constructor to create new ThemeInfo instances.
Improved support for multiple ArgInfos
ArgInfosMultiple argument info instances were supported in one of the Nitrocid KS 0.1.0 pre-release versions, including milestones, but they were not given enough testing for edge cases, such as calendar. As a result of the recent changes that were made to the shell, it no longer worked properly.
We've decided to improve support for multiple argument information instances by refactoring the code base in a way that makes UESH recognize this edge case.
For the most part, you don't need to call these functions, unless you're explicitly using them for some reason; CommandParameters parameters is more than enough.
Initial configuration for presets
We're in the process of changing how setting the presets up works in a way that it would deal with custom shell presets, such as those that were installed by the addons.
Earlier, the preset manager would only save changes for the built-in Nitrocid shells, but we wanted to extend this ability to save your preset selection to your custom shells.
The SPreset settings has changed so that it would align with the set preset. SetPresetDry() has been removed, because we've made SetPreset() dry.
KernelFlags removed
The central KernelFlags class used to hold all the read-only flags that mods could access. Since it has shown a need for an unnecessary reference to a Configuration namespace of the kernel, we've decided to remove the KernelFlags class completely.
The flags themselves, however, are moved to their respective classes, depending on which feature uses the flag. Here are the three examples:
ConsoleSupportsTrueColor: Moved toConsoleExtensionsKernelShutdown: Moved toPowerManagerQuietKernel: Moved toKernelEntry
The full list is being populated soon, due to current network-wide problems that prevent us from filling this list.
Once the full list is populated, follow this list to be able to migrate from KernelFlags.
Changes to the time zone API
We've made changes to the time zone API so that we could add new features to the API. However, this API had an outstanding problem with GetTimeZones() that did one thing too much: getting the current date and time with the time zone.
So, we've decided to split this function to two functions:
GetTimeZoneNames(): Gets the time zone namesGetTimeZoneTimes(): Gets the time zone times using the current date and time
We advice you to use one of these functions, depending on whether you want time zone names or current times.
Renamed two classes
The two classes have been reported to use the same name as the namespace, so we've decided to rename the two above classes to avoid ambiguity.
You no longer have to fully qualify these two classes anytime you need access to these classes.
The below classes have been renamed:
Presentation->SlideshowFilesystem->FilesystemTools
Used separate settings entry for default figlet font
BannerFigletFont was used by literally one feature, which is an old feature. However, we wanted to increase the customizability of this feature, so we've decided to implement a new settings entry for the default figlet font to replace the two above properties.
This settings entry still represents the name, so you just need to change from BannerFigletFont to TextTools.DefaultFigletFontName
Refactored the arguments help system
The arguments help system has been refactored exactly as we've done earlier to the UESH help system in an attempt to increase consistency and maintainability.
The printing tools, however, stay internal until Beta 3 gets released after enough tests have been made.
None of the functions found inside the class have been affected. It's just that you have to update the class name to ArgumentHelpPrint and the imports to KS.Arguments.Help.
Refactored the remote debug help system
The remote debug help system has been refactored exactly as we've done earlier to the UESH help system in an attempt to increase consistency and maintainability.
The printing tools, however, stay internal until Beta 3 gets released after enough tests have been made.
None of the functions found inside the class have been affected. It's just that you have to update the class name to RemoteDebugHelpPrint and the imports to KS.Kernel.Debugging.RemoteDebug.Command.Help.
No prefixing for editor functions
When text and file editors were implemented, we had to prefix every command and function with the editor type prefix, separated by the underscore character and the actual function name, such as JsonShell_OpenJsonFile().
However, this was a requirement as we had been using Visual Basic as the langauge when we first developed the first version of Nitrocid KS and every component had a single namespace at the time, which is KS before the migration.
Since we've moved to using namespaces and to using C# as the language used for the development of 0.1.0, we've decided to remove the prefixing from the editor functions and all the shell commands to show that namespaces are useful.
You can invoke the editor functions by removing the prefix, such as JsonShell_OpenJsonFile() being just OpenJsonFile() from JsonTools.
Moved ShellStart and ShellTypeManager functions
ShellStart and ShellTypeManager functionsWe're aiming for simplicity and stability across the Nitrocid API, so we've moved all the functions found in the two above classes to ShellManager, making them easier to access.
None of the functions or their signatures are changed. Update all the references to ShellStart and ShellTypeManager to ShellManager.
Help helpers are now turned to methods in argument info
Earlier, we used to have a property in ArgumentInfo, called AdditionalHelpAction, that contains a function telling you about tips for using a specified command when the help system is being requested to display the usage information to the user, similar to how it worked for the UESH shell.
Because we've implemented the arghelp command to the administrative shell, and we wanted to stay consistent in terms of performance, we've decided to replace the AdditionalHelpAction property with the HelpHelper() function that is overridable from the base argument executor class, ArgumentExecutor.
If you want additional help to be displayed, move the additional help action code to the HelpHelper() block, assuming that you've overridden it like below:
Implemented NotificationProgressState
NotificationProgressStateProgressFailed was implemented as a way to indicate that the progress has failed. Back then, the progress being 100% meant that the progress notification indicates that the progress is complete. However, we wanted a more accurate way to have the basic progress statistics.
As a result, we need to implement the NotificationProgressState enumeration to more accurately represent the progress state for a single progress notification, determinate or not.
If you want the progress notification to indicate failure, you'll have to set the ProgressState property value to NotificationProgressState.Failure.
Auto completer gains access to the list of last arguments
The auto completer now has access to the list of last passed arguments. This means that the auto completer function can now adapt to the passed arguments, such as listing all extension handlers for the specific extension.
We had to change the auto completer part to Func<string[], string[]> in order to accommodate this change.
Change the auto completer definitions in your CommandArgumentPart instances to hold the new function signature. This new function signature holds information about the last passed arguments.
Process execution moved
The ProcessExecutor was located in the following namespace:
This namespace was normally reserved for built-in shell commands. However, the process execution has nothing to do with the built-in UESH commands, although the shell considers these as commands. They're just external processes that can be executed right from the shell.
As a result, we've moved the ProcessExecutor class to the ProcessExecution part of the above namespace.
The ProcessExecutor class can now be called by importing the below namespace:
KS.Shell.ShellBase.Commands.ProcessExecution
Moved KernelTools' properties to KernelMain
KernelTools' properties to KernelMainThe kernel entry point used to have the name of Kernel since the inception of Nitrocid KS (Kernel Simulator back then) on 2018. Over time, the kernel got improved to the point that it's now become a massive operating system simulator that contains many useful tools.
As a result, we've moved the KernelVersion and the KernelApiVersion properties to the KernelMain class, which hosts the entry point of the simulator, and removed the KernelTools class.
You can still access the two properties, though they're now re-located to the KernelMain class in the KS.Kernel namespace.
Out Property Removed
Out Property RemovedThis property was added as part of the console wrapper class and as part of the console driver. It was added back when the shell had to manipulate with this property to nullify any output coming from the cancellation handler.
The thing is that this property was made under the assumption that it can be used to write output to the console and that it can be set, despite it being only useful for low-level scenarios, which are extremely rare.
As a result, for safety, we've decided to remove this property. The next breaking change is going to be about opening the input, the output, and the error output stream.
We advice you to stop using this property.
Moved SpeedDial to Network Base
SpeedDial to Network BaseThis speed dial namespace menioned above was moved to the network base namespace, KS.Network.Base.SpeedDial. The reason for this migration is that because the speed dial functionality is integrated with the base network features.
None of the speed dial classes (or any of their associated functions) have been changed. It's just that you have to update your usings so that it points to the KS.Network.Base.SpeedDial namespace.
Events and reminders config changes
When it comes to the events and the reminders feature in the Calendars addon, you may notice that their configuration file formats have changed from the XML representation of said events or reminders to the JSON representation.
As a result, you'll have to manually change your configuration files related to such events and reminders to follow this suit:
File extension is renamed from
.kseventor.ksreminderto.jsonContents changed from XML to JSON
Until tests are done, there are no clear instructions as to how to convert these configuration files. Be patient as they'll come soon.
Removed command type from CommandInfo
CommandInfoThe command type used to be required when defining CommandInfo instances back when the shell didn't have a straightforward way in defining shell commands across different shells. This was proven difficult when defining custom mod commands, essentially making the mod developers either use Shell as a workaround, which is essentially clumsy, or make a custom shell for just their commands, which is ugly.
So, amidst the recent changes made to the core of the UESH, we've decided that the shell type argument is redundant, especially when RegisterCustomCommand() and its siblings appeared. As a result of this function appearing, we've decided to finally nerf this requirement out of the definition of the CommandInfo, essentially making it easier to use.
This was planned a long time ago, but it didn't really occur to us that such a change required tons of core changes to the UESH shell handling facility to get rid of extraneous arguments that are required.
Just remove all references to the shell type in the second argument in your CommandInfo definitions, and you're good to go. Then, use RegisterCustomCommand() or its siblings to register them to your custom shell or one of the Nitrocid shells, such as Shell.
Removed ListModsStartingWith()
ListModsStartingWith()We've removed this function, because it was made only to help the UESH auto completer find all your mods.
If you really want this function, you can re-implement it using this link as a reference.
Placeholder management handles arguments
The placeholder management used to be rigid when it came to parsing advanced placeholders with arguments separated by the first colon. We wanted to extend this functionality to be able to register placeholders that are able to behave according to the argument passed to it, so we've decided to introduce a new class, PlaceInfo, and change the placeholder action to hold the argument as the first argument.
You must change your code so that the placeholder actions pass the first argument, if necessary. Example is provided in the placeholders page.
Language information class overhauled
While we were converting all the classes to use properties in the middle of the 0.1.0 development cycle, we came across LanguageInfo still using read-only fields, like Codepage and Transliterable, that we completely forgot to update.
We've recently converted these read-only fields to properties so that consistency was achieved. As a consequence, two functions from the language manager have to be changed.
The return value for these functions have changed to CultureInfo[], so you need to make necessary changes.
Moved some shells to their own individual addons
Some shells used to be defined directly by the base kernel for easy access. Since the introduction of addons, many features that didn't directly have to do with the core kernel got moved.
Now, in addition to these features, the following shells got moved:
FTP Shell (networked)
HTTP Shell (networked)
Mail Shell (networked)
RSS Shell (networked)
SFTP Shell (networked)
JSON Shell (non-networked)
SQL Shell (non-networked)
This means that your mods can't directly access them, their settings, and their tools anymore.
The base network is not going to be moved to the addons, but expect its namespace to be updated soon.
Inter-mod communication updates
The inter-mod communication facility was expanded to include support for properties and fields. As a result, a separate class was needed to avoid bloating the kernel modification management class.
The creation of the InterModTools class is to organize all the inter-mod communication-related functions.
To continue using ExecuteCustomModFunction(), change the reference from ModManager to InterModTools.
Separated the input info box to its own class
The input version of the informational box used to reside on the same class as the normal modal and non-modal informational boxes. However, over time, we've discovered that we didn't need to bloat the class with input-related infoboxes. We've moved all the above functions to their own separate class, InfoBoxInputColor.
None of the functions were altered during the move. You must change the reference to InfoBoxColor so that it points to InfoBoxInputColor instead.
Kernel no longer caches background and foreground colors
The color caching was used as a way to speed up the color querying. However, as performance improvements to different areas of the kernel were witnessed during the third beta development, we've decided to scrap the color caching feature, resulting in the removal of both the CurrentForegroundColor and CurrentBackgroundColor properties.
Also, to promote the usage of the modern ways to set the background and the foreground color using ConsoleColor as a result of Terminaux's Color fully supporting ConsoleColor, we've decided to remove all the console wrappers for setting the background and the foreground colors.
You must replace both wrappers with SetConsoleColor() prior to writing text plainly. Otherwise, usage of the built-in console writers is more appropriate and easier.
Number sorting tools moved
Although this driver didn't appear on Beta 2, we've added this in case your mod supports a particular development version of Beta 3 by targeting mod API 3.0.25.282 or lower.
We've created ArrayTools to put all the useful functions for arrays in one class. As a result, we've had to move all the functions inside SortingDriver to that class.
None of the functions are changed. You must change the ArrayTools references to point to SortingDriver instead.
New ways of manipulating objects in the JSON shell
The Add() and Remove() functions for each object type had been troublesome for a very long time and were error-prone, because of how they were coded. This was a problem with the JSON shell that's absolutely affecting its maintenance.
The solution was to implement brand new functions, Add(), Set(), and Remove(), that allow you to add objects, arrays, or properties to your JSON file at any location you choose.
The old Add() and Remove() functions were made obsolete as a result of the malleability of the three new functions. It's recommended to use the new functions.
Infobox classes moved to Inputs
InputsThe informational box classes used to reside in the FancyWriters part of the console writer. However, when we added several input methods to the information box class, we've discovered that this feature was not actually one of the writers, but one of the input methods.
To clear up the confusion, we've decided to move all the info box classes to the Inputs.Styles namespace.
None of the classes and their functions were affected, but you must change the imports clause to point to the new namespace, KS.ConsoleBase.Inputs.Styles.
Removal of delta-based refresh in the interactive TUI
The interactive TUI came with the built-in refresh mode that was, at the time, slow on Linux systems. We've attempted to rectify this by implementing the delta-based refresh, but recent improvements have caused slowdowns.
The interactive TUI now uses the Screen feature that's available starting from 0.1.0 Beta 3, which means that the delta-based search has to be eliminated in favor of the speed improvements that the Screen feature brings, along with the malleability regarding the console resizes.
To learn more about the Screen feature, visit the link below:
https://github.com/Aptivi-Stable-Docs/nks-manual-0.1.0-rc/blob/main/versions-and-compatibility/compatibility-notes-for-ks-api-revisions/upgrading-to-api-v3.0/broken-reference/README.mdRemove all calls and overrides to the above removed functions, because they no longer exist. The interactive TUI now internally uses the Screen feature, which means that it has not only become faster, but it has become more resilient when it comes to console resizes.
Adaptive hex and text editor TUIs
Although this feature is not introduced in the second beta version of Nitrocid KS 0.1.0, we've added this change for beta testers who produce mods that work on development trunk versions.
The hex and the text editor interactive TUIs have recently undergone an improvement regarding the flexibility of opening any file other than their respective shells, causing this breaking change to break all mods that target 3.0.25.304 or lower.
The Actions have changed to take a function delegate with the array of bytes or strings as input and as output.
Renamed CloseTextFile() in JsonTools
CloseTextFile() in JsonToolsThis was a development overlook when we were implementing the JSON shell tools. Now that we've finally spotted the mistake in naming, we've changed its name to CloseJsonFile() to clear up confusion.
This function's name has changed to the above name. Its behavior is not changed. You should update all references to the CloseTextFile() function to point to the new name.
Remote chat tools renamed
Although this feature is not introduced in the second beta version of Nitrocid KS 0.1.0, we've added this change for beta testers who produce mods that work on development trunk versions.
Its namespace needed updating, but the problem was that the class was named in the same name as the namespace in which we're going to update, so we've renamed this class to RemoteChatTools.
This change breaks all mods that target version 3.0.25.307 or lower. You need to update the namespace imports to KS.Kernel.Debugging.RemoteDebug.RemoteChat and the class references to RemoteChatTools.
JSON and SQL shell became separate addons!
As part of the JSON and SQL shell being addons, we've decided to make adjustments to some of the JSON shell tools so that the ones that are relevant to the JSON shell are put to its own tools, while the beautification and the minification of the JSON files stayed in Nitrocid's JSON tools.
However, we felt that this class needed a movement because of the separation, so we've moved this class to the KS.Misc.Text namespace.
You can still use the JSON beautification and minification tools if you update the imports to point to the KS.Misc.Text namespace.
Screen and Splashes
The splashes were unresponsive to the console resize, except when written to respond to such events, making most of them naturally unresizable.
The screen feature that was introduced in Nitrocid KS 0.1.0 Beta 3 allowed us to implement naturally resizable splash screens that refresh themselves upon resize.
The splash code must update their overrides to use the new signatures:
Afterwards, you must update the code in all of the overrides (if any) so that it builds a string full of VT sequences and text to print to the console. For example, the Welcome splash screen has been adjusted to use this feature.
Implemented ArgumentParameters
ArgumentParametersThe ArgumentParameters class was implemented to group the variables intended to show argument and switch lists. This is to avoid having to change the signature of the whole Execute() method every single addition or removal is planned.
The Execute() signature has been changed, so you need to update all your inherited argument classes to hold the new signature:
Implemented by:
Implemented RemoteDebugCommandParameters
RemoteDebugCommandParametersThe RemoteDebugCommandParameters class was implemented to group the variables intended to show argument and switch lists. This is to avoid having to change the signature of the whole Execute() method every single addition or removal is planned.
The Execute() signature has been changed, so you need to update all your inherited remote debug command classes to hold the new signature:
Implemented by:
Moved KernelPathType to Files.Paths
KernelPathType to Files.PathsWe've moved KernelPathType to its own namespace under the Files namespace, called Paths, since the custom paths got implemented.
With this change, we've also moved the following classes to Files.Paths:
Paths->PathsManagementPathLookupTools
For calls to Paths, you need to reference it again under the new class name, PathsManagement.
For the rest of the classes, you need to update the namespace imports to Files.Paths.
Moved input modes to their own namespaces
The three input modes have been moved to their own namespaces, because we wanted to organize the KS.ConsoleBase.Inputs.Styles namespace to be clean in case we add more input modes.
The following three input modes are affected:
ChoiceStyle->KS.ConsoleBase.Inputs.Styles.ChoiceIts accompanying
ChoiceOutputTypehas been moved to the above namespace
InfoBoxButtonsColor->KS.ConsoleBase.Inputs.Styles.InfoboxInfoBoxColor->KS.ConsoleBase.Inputs.Styles.InfoboxInfoBoxInputColor->KS.ConsoleBase.Inputs.Styles.InfoboxInfoBoxProgressColor->KS.ConsoleBase.Inputs.Styles.InfoboxInfoBoxSelectionColor->KS.ConsoleBase.Inputs.Styles.InfoboxInfoBoxSelectionMultiColor->KS.ConsoleBase.Inputs.Styles.InfoboxSelectionMultipleStyle->KS.ConsoleBase.Inputs.Styles.SelectionSelectionStyle->KS.ConsoleBase.Inputs.Styles.Selection
The above input modes have been moved to the above namespaces, so you need to update your namespace imports to reference the above namespaces.
Moved advanced diagnostics to its own addon
This function used to use an advanced diagnostics package, called ClrMd, that facilitates the diagnostics by providing tools that are effective, such as getting all the thread backtraces.
Because the entire kernel debugging system, except a very small part of it, used such diagnostics, we've moved such tools to its own Extras addon. This is not done in an effort to attempt to reduce dependencies to its bare minimum, and may be reinstated in a future release post-0.1.0.
This function has not been removed, but it has been modified to call the same function using the inter-addon communication recently implemented in the third beta version of 0.1.0.
When your mod calls this function, be sure to handle an extra case where it returns an empty dictionary.
SpecProbe updated to 1.2.0
This is not exactly an API-related breaking change, but this is a breaking change for Windows users. Linux and macOS are not affected.
When SpecProbe was updated to 1.2.0, it contained a re-written hard disk prober that gets all the hard drives and their partitions without relying on DriveInfo.GetDrives() to get all the mounted drives. As a result, it returned a more complete partition list in your hard drives if you're running Windows.
However, this re-written hard disk prober requires administrative rights, because it calls DeviceIoControl(), which is considered a powerful function for device I/O controls, such as getting drive geometry, getting drive partition table information, and so on. That function was used to directly talk to your drive for such information, which is why it requires administrator rights.
As a result, Nitrocid KS 0.1.0 Beta 3 will start requiring administrative privileges, starting from commit dda1d6d. However, the final version won't ask for administrative privileges unless you explicitly tell it to reboot to the elevated mode on Windows systems.
Renamed RemovePostfix() to RemoveSuffix()
RemovePostfix() to RemoveSuffix()It has been recently discovered that "postfix" is less understandable than "suffix" for some of the users, so we've adjusted the name of the function to better align with these requirements.
The functionality of this function wasn't changed while renaming this function.
Removed hidden commands
Normally, the hidden commands serve as a way to hide a selected command that may have a secret in it. However, it is not completely hidden, because mods can be reverse-engineered using the .NET reverse engineering tools to get the name of the command, which causes this command to be no longer hidden.
We've decided to remove this feature for this reason.
We advice you to stop using this feature.
Removed mod parts
Mod parts were historically implemented as a way to group parts of one mod when they were just a single C# source code file. That was a way to group several parts of a mod to achieve their own goal.
The problem was that we've taken out support for such mods and replaced them with DLL-based mods, which are still used at this moment because they don't require dynamically compiling the source code with CodeDom. As a result, we've negated the role of CodeDom in terms of loading mods and their so-called "parts".
Upon further examination as to how the mods are loaded, we've reached to a conclusion that mod parts went useless as more and more improvements went in the way to the mod loading system. This feature has now become a maintenance burden when it comes to maintaining the mod system, especially the part where we would finalize the mod for a specific mod. Recent changes to the modding system have also concluded that mod parts are just categorical sugar.
As a result, we've decided to finally remove the mod parts as their role has been cancelled by DLL-based mods and as C# source code-based mods were long removed from the mod loading system to get rid of CodeDom.
This only breaks your mod manager code as it only changes the kernel mod information class and not the mod interface itself. Your mods should still work properly.
Moved permissions to Security
SecurityThe user permissions feature was implemented as a way to control what users can and cannot do. As a result, it's considered as a security feature more than it's a user accounts feature. Hence, the feature needs to be moved to the Security namespace.
None of the functions have been changed as a result of this move. You just need to update your imports to KS.Security.Permissions.
Notification handling changes
Progress notification's handling has changed, because we no longer look for the progress percentage. We only look for the state now to accurately reflect the success or the failure.
As a result, your progress notifications have to change their state to either a success or a failure, even when their progress property went to 100%. You can simply do this:
Improved custom language loading functions
InstallCustomLanguage() used to only handle languages that have been installed to the custom languages path located in the application data folder. Over time, during the entire span of development, we've noticed that this feature was the least tested feature, so we've decided to take care of it.
By taking care of it, we'd agreed that we'd change the InstallCustomLanguage() function so that it takes a path to the JSON file of a language that isn't installed to the kernel yet, and that we'd make a new function that derives from it, called InstallCustomLanguageByName(), to preserve the old behavior of pre-Beta 3 versions.
If you still want to use the language name, you need to change the function so that it calls its ...ByName() sibling instead of the primary one, which now takes the path.
Moved KernelColorType versions of writers
KernelColorType versions of writersBecause the KernelColorType version of all console writers are not part of Terminaux's standard console writers, we've decided to isolate this version of these functions that write text to console in different styles so the following classes house them:
TextWriters: Standard console writing, including positioning and slow writing.TextFancyWriters: Fancy console writing, including Figlet writing and simple console graphics.TextMiscWriters: Miscellaneous console writing, including line with handle writer.
This change was done as a preparation for the deduplication effort happening as soon as the release candidate cycle starts.
If you wish to use the above KernelColorType-based writers, you need to change the class reference to one of the three above classes. Here are three examples:
TextWriterColor.WriteKernelColor->TextWriters.WriteFigletColor.WriteFigletKernelColor->TextFancyWriters.WriteFigletListWriterColor.WriteList->TextWriters.WriteList
Terminaux 2.0 migration changes
Nitrocid KS 0.1.0 Beta 3 uses Terminaux 2.0 to handle color work. As a result, we need you to consult the changelogs for this version of Terminaux here:
Last updated