-
Notifications
You must be signed in to change notification settings - Fork 3
Check for updates
When you create a software, you usually want to update it to add new features or correct bugs. Thanks to LeoCorpLibrary, it's very simple to implement an update system.
To use the methods and other features of LeoCorpLibrary, dont forget to add this line of code on top of your code file.
C#
using LeoCorpLibrary;
VB
Imports LeoCorpLibrary
This function is available in version 1.1 and higher.
Compatibility
Framework | LeoCorpLibrary | LeoCorpLibrary.Core |
---|---|---|
.NET 5 | ✔ | ✔ |
.NET Core 3.1 | ✔ | ✔ |
.NET Framework 4.7.2 | ✔ | ✔ |
.NET Framework 4.5 | ❌ | ✔ |
The IsAvailable()
method allows you to check if a updates are avaialable for your software. Returns a bool
value.
LeoCorpLibrary.Update.IsAvailable()
Note: You need to place the namespace
LeoCorpLibrary
before theUpdate
class because of a conflict withControl.Update
.
Here's this method's arguments
Type | Argument | Description | Example |
---|---|---|---|
string | version | Curent version of the software | "1.0.0.0" |
string | lastVersion | Last version of the software | "1.1.0.0" |
Here's an example of usage that uses the GetLastVersion method:
C#
string lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
if (LeoCorpLibrary.Update.IsAvailable("1.0.0.0", lastVersion)) // If updates are available
{
MessageBox.Show("Update available");
}
else
{
MessageBox.Show("No update available");
}
VB
Dim lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
If (LeoCorpLibrary.Update.IsAvailable("1.0.0.0", lastVersion)) Then ' If updates are available
MsgBox("Update available")
Else
MsgBox("No update available")
End If
This function is available in version 1.1 and higher.
Compatibility
Framework | LeoCorpLibrary | LeoCorpLibrary.Core |
---|---|---|
.NET 5 | ✔ | ❌ |
.NET Core 3.1 | ✔ | ❌ |
.NET Framework 4.7.2 | ❌ | ❌ |
.NET Framework 4.5 | ❌ | ❌ |
The Check()
method allows you to check updates for your software. If updates are available, a specified form will show. Same thing if no updates are available.
LeoCorpLibrary.Update.Check()
Note: You need to place the namespace
LeoCorpLibrary
before theUpdate
class because of a conflict withControl.Update
.
Here's this method's arguments
Type | Argument | Description | Example |
---|---|---|---|
string | version | Curent version of the software | "1.0.0.0" |
string | lastVersion | Last version of the software | "1.1.0.0" |
Form | availableUpdateForm | Form to show when updates are available | Form1 |
Form | noUpdateForm | From to show when no updates are available | Form2 |
Here's an example that uses the GetLastVersion method:
C#
string lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
LeoCorpLibrary.Update.Check("1.0.0.0", lastVersion, new MAJ_AV(), new MAJ_UN());
// A window will open depending on the result
VB
Dim LastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
LeoCorpLibrary.Update.Check("1.0.0.0", LastVersion, new MAJ_AV, new MAJ_UN)
' A window will open depending on the result
This function is available in version 2.2 and higher.
Compatibility
Framework | LeoCorpLibrary | LeoCorpLibrary.Core |
---|---|---|
.NET 5 | ✔ | ❌ |
.NET Core 3.1 | ✔ | ❌ |
.NET Framework 4.7.2 | ❌ | ❌ |
.NET Framework 4.5 | ❌ | ❌ |
The CheckWPF()
method allows you to check updates for your software. If updates are available, a specified window will show. Same thing if no updates are available.
LeoCorpLibrary.Update.CheckWPF()
Note: You need to place the namespace
LeoCorpLibrary
before theUpdate
class because of a conflict withControl.Update
.
Here's this method's arguments
Type | Argument | Description | Example |
---|---|---|---|
string | version | Curent version of the software | "1.0.0.0" |
string | lastVersion | Last version of the software | "1.1.0.0" |
Form | availableUpdateWindow | Window to show when updates are available | Form1 |
Form | noUpdateWindow | Window to show when no updates are available | Form2 |
Here's an example that uses the GetLastVersion method:
C#
string lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
LeoCorpLibrary.Update.Check("1.0.0.0", lastVersion, new MAJ_AV(), new MAJ_UN());
// A window will open depending on the result
VB
Dim LastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
LeoCorpLibrary.Update.Check("1.0.0.0", LastVersion, new MAJ_AV, new MAJ_UN)
' A window will open depending on the result
This function is available in version 1.1 and higher.
Compatibility
Framework | LeoCorpLibrary | LeoCorpLibrary.Core |
---|---|---|
.NET 5 | ✔ | ⚠ |
.NET Core 3.1 | ✔ | ⚠ |
.NET Framework 4.7.2 | ✔ | ✔ |
.NET Framework 4.5 | ❌ | ✔ |
The GetLastVersion()
method download a string
from a specfic webpage where a .txt
file that contains the last version. Returns a string
.
This method has only one argument:
Type | Argument | Description | Example |
---|---|---|---|
string | lastVersionFileLink | Link of the file that contains the last version | "https://example.com/Version.txt" |
Note: You need to place the namespace
LeoCorpLibrary
before theUpdate
class because of a conflict withControl.Update
.
Here's an example of usage:
C#
string lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
// You can use the lastVersion variable in the IsAvailable() method.
// or in the Check() method.
VB
Dim LastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
' You can use the lastVersion variable in the IsAvailable() method.
' or in the Check() method.
This function is available in version 1.1 and higher.
Compatibility
Framework | LeoCorpLibrary | LeoCorpLibrary.Core |
---|---|---|
.NET 5 | ✔ | ❌ |
.NET Core 3.1 | ✔ | ❌ |
.NET Framework 4.7.2 | ❌ | ❌ |
.NET Framework 4.5 | ❌ | ❌ |
The Install()
method allow to install an update for your software. if you want to update your program using this method, we advice you to uise this method in another program (Updater). This program needs admin privileges to update the software. You can enable this feature in app.manifest
. You can create it in Visual Studio. Edit this:
- <requestedExecutionLevel level="asInvoker" uiAccess="false" />
+ <requestedExecutionLevel level="requireAdministrator" uiAccess="false" />
Here's this method's arguments:
Type | Argument | Description | Example |
---|---|---|---|
string | filePath | Location of the file | "C:/Programme/Program.exe" |
string | lastVersionLink | Link of the new file | "https://example.com/Program.exe" |
bool | fromAppStartupPath | (Optional) Open the file from Application.StartupPath | true |
Note: You need to place the namespace
LeoCorpLibrary
before theUpdate
class because of a conflict withControl.Update
.
Example:
C#
string link = "https://dl.dropboxusercontent.com/s/tlekj6j834tgi3r/GestionPersoX.exe";
LeoCorpLibrary.Update.Install("C:/Programme/Programme.exe", link);
// If the program is in 'C:\Program'
LeoCorpLibrary.Update.Install("/Programme.exe", link, true)
VB
Dim link = "https://dl.dropboxusercontent.com/s/tlekj6j834tgi3r/GestionPersoX.exe"
LeoCorpLibrary.Update.Install("C:/Programme/Programme.exe", link)
' If the program is in 'C:\Progtam'
LeoCorpLibrary.Update.Install("/Programme.exe", link, True)
This function is available in version 2.1 and higher.
Compatibility
Framework | LeoCorpLibrary | LeoCorpLibrary.Core |
---|---|---|
.NET 5 | ✔ | ⚠ |
.NET Core 3.1 | ✔ | ⚠ |
.NET Framework 4.7.2 | ✔ | ✔ |
.NET Framework 4.5 | ❌ | ✔ |
The GetLastVersionAsync()
method allows you to obtain the last version of the software asynchronously from a *.txt
file.
It's in
LeoCorpLibrary.Update.GetLastVersionAsync()
Here's this method's argument:
Type | Argument | Description | Example |
---|---|---|---|
string | lastVersionFileLink | Link of the file where is stored the last version | "https://example.com/Version.txt" |
Note: You need to place the namespace
LeoCorpLibrary
before theUpdate
class because of a conflict withControl.Update
.
Here's an example of usage:
C#
async void GetVersion()
{
string version = await LeoCorpLibrary.Update.GetLastVersionAsync("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
}
VB
Private Async Sub GetVersion()
Dim version As String = Await LeoCorpLibrary.Update.GetLastVersionAsync("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
End Sub
© 2021 Léo Corporation and contributors