Electron Desktop App Development · درس

تطبيق التحديثات التلقائية

ادمج ميزات التحديث التلقائي في تطبيق Electron باستخدام `electron-updater` لتقديم الإصدارات الجديدة إلى المستخدمين بسلاسة

تطبيق التحديثات التلقائية درس مجاني في Electron Desktop App Development على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Electron Desktop App Development، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Electron Desktop App Development 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

Why Auto-Updates?

Keeping your desktop application up-to-date is crucial for user experience and security. Auto-updates ensure users always have the latest features and bug fixes.

Improved Security: Patches vulnerabilities quickly.
New Features: Delivers enhancements without manual effort.
Bug Fixes: Resolves issues seamlessly.
Better User Experience: Users enjoy a consistently fresh and stable app.

Introducing `electron-updater`

electron-updater is a powerful module that simplifies adding auto-update functionality to your Electron app. It handles the complex logic of checking for new versions, downloading them, and installing them.

It works by looking for new releases on a configured update server (like GitHub Releases, Amazon S3, or a custom server) and managing the update process.

Installation & Setup

First, you need to install electron-updater as a dependency in your Electron project. It's best to add it as a regular dependency, not a dev dependency, as it's part of your deployed application.

Open your terminal in your project's root directory and run:

npm install electron-updater

Initial Setup in `main.js`

To use electron-updater, you'll primarily work in your app's main process (usually main.js). You'll import autoUpdater and call its checkForUpdates() method when your app is ready.

Note: This code is part of an Electron app's main process and requires a full Electron environment to run. It won't execute in a standard JavaScript playground.

const { app, BrowserWindow } = require('electron');
const { autoUpdater } = require('electron-updater');

// ... other app setup ...

app.on('ready', () => {
  // createWindow(); // Your window creation function
  autoUpdater.checkForUpdates();
  console.log('Checking for updates...');
});

// ... other app lifecycle events ...

Understanding Update Events

electron-updater uses an event-driven model. This means you 'listen' for specific events that occur during the update process and react to them. This allows you to provide feedback to your users.

checking-for-update: Update check started.
update-available: New version found.
update-not-available: No new version.
download-progress: Update download progress.
update-downloaded: Update ready to install.
error: Something went wrong.

Handling `checking-for-update`

The checking-for-update event is fired as soon as checkForUpdates() is called. It's a good place to show a loading indicator or a message to the user.

Remember: This code needs to be in your Electron main.js file.

const { autoUpdater } = require('electron-updater');

autoUpdater.on('checking-for-update', () => {
  console.log('App is now checking for updates...');
  // You might send a message to the renderer process
  // to update the UI here.
});

Handling `update-available`

When electron-updater finds a new version, it emits the update-available event. At this point, the update download usually begins automatically. You can use this event to notify the user that an update is being downloaded.

const { autoUpdater } = require('electron-updater');

autoUpdater.on('update-available', (info) => {
  console.log(`Update available! Version: ${info.version}`);
  // Display a message to the user that an update is downloading.
});

Handling `update-downloaded` & Install

Once the update has been fully downloaded, the update-downloaded event is emitted. This is the critical moment! You should notify the user and ask them to restart the application to apply the update.

The autoUpdater.quitAndInstall() method will close all windows and install the update, then relaunch the app.

const { autoUpdater } = require('electron-updater');

autoUpdater.on('update-downloaded', (info) => {
  console.log('Update downloaded. Restarting app to install...');
  // In a real app, you'd prompt the user here:
  // dialog.showMessageBox({ /* ... */ }).then(() => autoUpdater.quitAndInstall());
  autoUpdater.quitAndInstall();
});

Handling Errors & No Updates

It's important to handle cases where there are no updates or if an error occurs during the process. The update-not-available event lets you know when your app is already the latest version.

The error event is crucial for debugging and informing users if something went wrong during the update check or download.

const { autoUpdater } = require('electron-updater');

autoUpdater.on('update-not-available', (info) => {
  console.log('No new updates available.');
});

autoUpdater.on('error', (err) => {
  console.error('Error during auto-update:', err);
  // You might display an error message to the user.
});

Update Flow Check

You've learned about the main events in the electron-updater lifecycle. Which of the following statements about auto-updates are generally true?

Recap: Keep Your App Fresh!

In this lesson, you've learned how to implement auto-update functionality in your Electron applications using the electron-updater module.

We covered its installation and basic setup in the main process.
You explored key events like checking-for-update, update-available, update-downloaded, and error.
Understanding these events allows you to build a robust and user-friendly update experience, ensuring your users always have the best version of your app.

الأسئلة الشائعة

هل درس «تطبيق التحديثات التلقائية» مجاني؟

نعم — نص درس «تطبيق التحديثات التلقائية» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Electron Desktop App Development، انتقل إلى CoddyKit PRO. تتضمن دورة Electron Desktop App Development 4 دروس في المجموع.

ماذا ستتعلم في «تطبيق التحديثات التلقائية»؟

ادمج ميزات التحديث التلقائي في تطبيق Electron باستخدام `electron-updater` لتقديم الإصدارات الجديدة إلى المستخدمين بسلاسة تتمرن على Electron Desktop App Development مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Electron Desktop App Development؟

لا تُشترط خبرة سابقة. Electron Desktop App Development على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «تطبيق التحديثات التلقائية»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Electron Desktop App Development هذا؟

نعم. كل درس في Electron Desktop App Development يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Electron Desktop App Development