Electron Desktop App Development · درس

العمل مع الوحدات الأصلية

تعلّم كيفية دمج وحدات Node.js الأصلية الحالية (C/C++) واستخدامها داخل تطبيق Electron للمهام الحساسة للأداء

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

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

What are Native Modules?

Welcome! Today we'll explore Native Modules in Electron. These are special Node.js modules written in C or C++.

Think of them as powerful extensions that let your JavaScript code interact directly with the operating system at a lower level or perform high-speed computations.

Why Use Native Modules?

Native modules are used for specific, critical tasks:

Performance: For CPU-intensive operations that JavaScript might struggle with.
Low-level OS Access: Interacting with hardware or specific operating system features not exposed by Node.js or Electron's standard APIs.
Existing C/C++ Libraries: Reusing established, optimized C/C++ libraries directly within your Electron app.

Node.js Addons in Electron

Electron uses Node.js internally. This means any Node.js native addon (a C/C++ module compiled for Node.js) can also be used in your Electron application.

You'll typically load these modules in the main process, as it has full Node.js API access, and then expose necessary functions to the renderer process via IPC or preload scripts (covered in later lessons).

Prerequisites for Building

To build native modules, you need a few tools installed on your system:

Python: Version 2.7 (for node-gyp).
C/C++ Compiler: Like Visual Studio (Windows), Xcode Command Line Tools (macOS), or build-essential (Linux).
node-gyp: A cross-platform command-line tool written in Node.js for compiling native addon modules.

`node-gyp` Explained

node-gyp is crucial for native module development. It takes configuration files (binding.gyp) and uses them to generate platform-specific build files (like Makefiles or Visual Studio projects).

This allows your C/C++ code to be compiled correctly for your operating system and Node.js version, producing a .node file that Node.js (and Electron) can load.

Basic Structure (Concept)

A native module project typically includes:

C/C++ source files: Your core logic.
binding.gyp: A configuration file for node-gyp, specifying how to compile your C/C++ code.
package.json: Defines your module and its dependencies.

The compilation process turns your C/C++ code into a .node file, which is essentially a shared library.

Installation & Compilation

When you install an npm package that contains a native module, npm automatically runs node-gyp rebuild for you.

This command compiles the native code for your specific Node.js and Electron version, creating the .node file in a directory like ./build/Release/ or ./build/Debug/.

Loading in Electron

Once compiled, a native module can be loaded into your Electron application using the standard Node.js require() function.

You simply point to the compiled .node file. This is usually done in your Electron's main process, or in a preload script for the renderer process if you need to expose its functionality there securely.

Using a Native Module (JS Example)

Here's how you would use a hypothetical native module in your Electron application's JavaScript code. We'll simulate its functionality for this runnable example.

const path = require('path');

// In a real Electron app, you'd require the compiled .node file.
// Example: const myNativeAddon = require(path.join(__dirname, 'build/Release/myaddon.node'));

// For this runnable example, we'll simulate a native module interface.
const myNativeAddon = {
  greet: (name) => {
    return `Hello from native code, ${name}!`;
  },
  add: (a, b) => {
    console.log('Performing fast native addition...');
    return a + b;
  }
};

console.log("Electron app script running...");

// Use the functions exposed by the 'native' module
const greeting = myNativeAddon.greet("CoddyKit User");
console.log(greeting);

const sum = myNativeAddon.add(15, 25);
console.log(`The sum of 15 and 25 is: ${sum}`);

console.log("Script finished.");

Quick Check

Which of the following is NOT a primary reason to use Electron native modules?

Recap & Next Steps

Great job! You've learned about Node.js native modules in Electron:

They are C/C++ code compiled to .node files.
Used for performance, OS interaction, and C/C++ library integration.
node-gyp is the key tool for compilation.
They are loaded using require() in JavaScript.

Next, we'll look at creating Tray Applications and Badges, another way to leverage native features!

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

هل درس «العمل مع الوحدات الأصلية» مجاني؟

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

ماذا ستتعلم في «العمل مع الوحدات الأصلية»؟

تعلّم كيفية دمج وحدات Node.js الأصلية الحالية (C/C++) واستخدامها داخل تطبيق Electron للمهام الحساسة للأداء تتمرن على Electron Desktop App Development مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

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

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

كم من الوقت يستغرق درس «العمل مع الوحدات الأصلية»؟

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

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

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

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

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