Follow the compatibility notes when upgrading your mods to API v2.1 series
Last updated
When upgrading your modification from the target of the later version of Nitrocid KS that declares itself to be from the API v2.1, you must make necessary changes to be able to use your mod in a Nitrocid KS version which you use to test your mod.
The following changes were listed sequentially as development went on.
From 0.0.23 to 0.0.24
This version was released to make groundbreaking additions and improvements.
Removed support for ICustomSaver
ICustomSaver.vb
<Obsolete("This custom screensaver interface is obsolete. Use IScreensaver and BaseScreensaver instead.")>
Public Interface ICustomSaver
CustomSaverCompiler.vb
Public Sub CompileCustom(file As String)
Custom screensavers used to implement the ICustomSaver interface to implement the screensaver logic. Now, it has been removed in favor of the new screensaver class implementing the newer IScreensaver interface, BaseScreensaver.
This breaks all the existing screensavers that still use the old ICustomSaver interface. This has also resulted in the removal of the Custom() function and reimplementation as ParseCustomSaver.
All new screensavers should use the BaseScreensaver class. All existing screensavers should migrate from ICustomSaver to BaseScreensaver.
As for the parser, it has been reimplemented to take only the screensaver DLL files.
Removed support for PerformCmd()
IScript.vb
Sub PerformCmd(Command As CommandInfo, Optional Args As String = "")
CommandBase.Execute() was implemented to replace the above function, so we decided to remove the function as it only supported one command at a time, and you had to make a switch case statement for each command executed.
BaseCommand.Execute() can be overridden in the below method signature:
BaseCommand.cs
public virtual void Execute(string StringArgs, string[] ListArgsOnly, string[] ListSwitchesOnly)
Restructured the filesystem API
Filesystem module was a god class, so we decided to consolidate it to their own separate files to accomodate with the upcoming changes. However, you need to use their own namespace (for example, if you want to copy a file, import KS.Files.Operations) to be able to use them.
Filesystem.vb
Public Function SetSizeParseMode(Enable As Boolean) As Boolean
We have also removed SetSizeParseMode() as it's redundant and it was there for compatibility reasons.
The base Filesystem module will stay so that path neutralization and invalid path detection routines will still be available under the same namespace in 0.0.24.0 and above.
Removed functions:
SetSizeParseMode()
New namespaces:
KS.Files.Attributes
KS.Files.Folders
KS.Files.LineEndings
KS.Files.Operations
KS.Files.PathLookup
KS.Files.Print
KS.Files.Querying
KS.Files.Read
Choose one of the above namespaces to select the kind of filesystem operation you're going to do. However, these namespaces were written at the time of the change commit date, so the API documentation always gets up-to-date.
Separated ConsoleColors enumeration
Color255.vb
Public Enum ConsoleColors As Integer
This enumeration used to hold all the 255 console colors and their names for easier selection. It was just separated from the Color255 module to put it directly to the KS.ConsoleBase namespace
You can still use this enumeration in the Terminaux library.
Removed KS.Misc.Dictionary to substitute with Dictify
DictionaryManager.vb
Public Function GetWordInfo(Word As String) As DictionaryWord
DictionaryWord.vb
Public Class DictionaryWord
As Dictify got released, we decided to remove these functions and use them from the library.
You can still use these functions using the Dictify library.
Moved APIs to their own namespace
We have moved the below APIs to the below namespaces as they keep getting expanded:
Network transfer APIs -> KS.Network.Transfer
Color console APIs -> KS.ConsoleBase.Themes
Input console APIs -> KS.ConsoleBase.Inputs
Removed the progress and its report positions from SplashInfo
SplashInfo.vb
Public ReadOnly Property ProgressWritePositionX As Integer
Public ReadOnly Property ProgressWritePositionY As Integer
Public ReadOnly Property ProgressReportWritePositionX As Integer
Public ReadOnly Property ProgressReportWritePositionY As Integer
These four progress position variables were used to indicate where the splash manager should write the progress percentage and progress report. Splashes are now responsible for these.
We advice you to assign these variables in your splash code instead of using these fields.
Replaced CommandPromptWrite()
UESHShell.vb
Public Sub CommandPromptWrite()
CommandPromptWrite() used to be the helper for UESH to write its own prompt, but it's eventually replaced by the more powerful WriteShellPrompt() to accommodate all possible cases, like custom variables, and so on.
Your shell should use the PromptPresetBase class to define your own shell prompts.
PromptPresetManager.cs
public static void WriteShellPrompt(ShellType ShellType)
public static void WriteShellPrompt(string ShellType)
Organized the ShellBase namespaces
The shell base has been divided to three types:
Aliases (namespace: KS.Shell.ShellBase.Aliases)
Commands (namespace: KS.Shell.ShellBase.Commands)
Shells (namespace: KS.Shell.ShellBase.Shells)
Use the above namespaces if you want to perform operations in your own custom shell.
Changed progress bar writer module name
ProgressColor.vb
Public Module ProgressColor
We didn't want to cause confusion between ProgressColor in the FancyWriters namespace and the actual ProgressColor in the ColorTools module, so we decided to extend the name of the progress bar writer module to ProgressBarColor.
To utilize the progress bar writers, you need to use the KS.Misc.Writers.FancyWriters namespace and use the ProgressBarColor class methods.
