أدوات وبيئة التطوير on kenji.blog

كيفية نشر رسائل إلى Microsoft Teams من C++ (WinHTTP + Graph API)

Mon, 14 Jul 2025 23:40:15 +0900

كيفية نشر رسائل إلى Microsoft Teams من C++ (WinHTTP + Graph API)

هل ترغب في النشر التلقائي في دردشة Microsoft Teams؟ يمكنك استخدام ** Microsoft Graph API ** لذلك. في هذه المقالة، سنقدم ** أمثلة كود C++ باستخدام WinHTTP ** و ** خطوات مصادقة API المطلوبة ** خطوة بخطوة.

🔧 التحضيرات المطلوبة (إعدادات مصادقة Microsoft Graph API)

1. تسجيل التطبيق في بوابة Azure

أولاً، لاستخدام Microsoft Graph API، يجب عليك تسجيل تطبيقك في Azure.

انتقل إلى Azure Portal
** “Microsoft Entra ID” ** > ** “＋إضافة” ** > ** “تسجيل التطبيق” ** > ** “تسجيل جديد” **
أدخل اسم التطبيق الذي تريده وانقر على “تسجيل”

2. إضافة أذونات API

انتقل إلى “أذونات API” في القائمة اليسرى
في ** “Microsoft Graph” ** > ** “تحديد الأذونات” **، ابحث عن النطاقات التالية وانقر على ** “تحديث الأذونات” **

Chat.ReadWrite
User.Read

※ إذا كنت ترغب في النشر في قناة، فستحتاج أيضًا إلى ChannelMessage.Send

3. تدوين معرف العميل ومعرف المستأجر

احتفظ بالقيمتين التاليتين المعروضتين في علامة التبويب “نظرة عامة”:

معرف التطبيق (العميل)
معرف الدليل (المستأجر)

4. إنشاء سر العميل

انتقل إلى علامة التبويب “الشهادات والأسرار”
“سر عميل جديد” > قم بتعيين تاريخ انتهاء الصلاحية وانقر على “إضافة”
** تأكد من تدوين القيمة المعروضة (السر) على الفور **

🔐 الحصول على رمز الوصول (OAuth2)

سنستخدم تدفق client_credentials للحصول على الرمز. قم بتشغيل الأمر التالي باستخدام curl للحصول على رمز الوصول.

1
2
3
4
5
6
7


curl -X POST ^
 https://login.microsoftonline.com/{معرف المستأجر}/oauth2/v2.0/token ^
 -H "Content-Type: application/x-www-form-urlencoded" ^
 -d "client_id={معرف العميل}" ^
 -d "scope=https%3A%2F%2Fgraph.microsoft.com%2F.default" ^
 -d "client_secret={سر العميل}" ^
 -d "grant_type=client_credentials"

مثال على الاستجابة

1
2
3
4
5
6


{
 "token_type":"Bearer",
 "expires_in":3599,
 "ext_expires_in":3599,
 "access_token": "eyJ0eXAiOiJKV1QiLCJub... (محذوف)"
}

استخدم access_token هذا لاستدعاء Microsoft Graph API.

💬 نموذج C++ للنشر في دردشة Teams

فيما يلي مثال بلغة C++ للنشر في دردشة باستخدام WinHTTP.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54


#include <windows.h>
#include <winhttp.h>
#include <iostream>
#include <string>

#pragma comment(lib, "winhttp.lib")

void PostToTeamsChat(const std::wstring& accessToken, const std::wstring& chatId, const std::wstring& message) {
 HINTERNET hSession = WinHttpOpen(L"TeamsPoster/1.0", WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
 WINHTTP_NO_PROXY_NAME, WINHTTP_NO_PROXY_BYPASS, 0);

 HINTERNET hConnect = WinHttpConnect(hSession, L"graph.microsoft.com", INTERNET_DEFAULT_HTTPS_PORT, 0);

 std::wstring endpoint = L"/v1.0/chats/" + chatId + L"/messages";
 HINTERNET hRequest = WinHttpOpenRequest(hConnect, L"POST", endpoint.c_str(), NULL,
 WINHTTP_NO_REFERER, WINHTTP_DEFAULT_ACCEPT_TYPES, WINHTTP_FLAG_SECURE);

 std::wstring jsonBody = L"{\"body\": {\"content\": \"" + message + L"\"}}";
 std::wstring headers = L"Authorization: Bearer " + accessToken + L"\r\nContent-Type: application/json\r\n";

 BOOL bResult = WinHttpSendRequest(hRequest,
 headers.c_str(), (DWORD)-1L,
 (LPVOID)jsonBody.c_str(), (DWORD)(jsonBody.length() * sizeof(wchar_t)),
 (DWORD)(jsonBody.length() * sizeof(wchar_t)), 0);

 if (bResult)
 WinHttpReceiveResponse(hRequest, NULL);

 DWORD dwSize = 0;
 WinHttpQueryDataAvailable(hRequest, &dwSize);

 if (dwSize > 0) {
 std::wstring response(dwSize / sizeof(wchar_t), 0);
 DWORD dwDownloaded = 0;
 WinHttpReadData(hRequest, &response[0], dwSize, &dwDownloaded);
 std::wcout << L"Response: " << response << std::endl;
 }

 WinHttpCloseHandle(hRequest);
 WinHttpCloseHandle(hConnect);
 WinHttpCloseHandle(hSession);
}

int main() {
 std::wstring access;
 std::wstring chatId = L"19:";
 std::wstring message = L"Hello from C++!";
 std::wcout << L"Enter your access token: ";
 std::getline(std::wcin, access);
 std::wcout << L"Enter chat ID: ";
 std::getline(std::wcin, chatId);
 PostToTeamsChat(access, chatId, message);
 return 0;
}

🔍 كيفية الحصول على معرف الدردشة

يمكنك التحقق من معرف الدردشة باستخدام GET /v1.0/me/chats.

1
2
3
4


curl -X GET ^
 https://graph.microsoft.com/v1.0/me/chats ^
 -H "Authorization: Bearer {access_token}" ^
 -H "Content-Type: application/json"

مثال على الاستجابة

1
2
3
4
5
6
7
8
9


{
 "value": [
 {
 "id": "19:abc123xyz@thread.v2",
 "topic": null,
 "chatType": "oneOnOne"
 }
 ]
}

📌 ملاحظات

هذا النموذج هو تنفيذ بالحد الأدنى. في بيئة الإنتاج:
- معالجة انتهاء صلاحية الرمز
- التحقق من شهادة HTTPS
- تعزيز معالجة الأخطاء
للنشر في القنوات، استخدم teams/{team-id}/channels/{channel-id}/messages.
لإرسال المرفقات، ستحتاج إلى معالجة متعددة الأجزاء أو Graph Drive API.

📎 الخلاصة

الميزة	الوصف
Graph API	واجهة برمجة التطبيقات الرسمية للتفاعل مع Teams
تسجيل التطبيق	إجراءات المصادقة المطلوبة على Azure
رمز الوصول	تم الحصول عليه عبر OAuth2 واستخدامه في الطلبات
تنفيذ C++	استدعاء Graph API باستخدام WinHTTP

🚀 الخطوات التالية

كأمثلة أكثر تقدمًا، يمكنك أيضًا:

النشر في قنوات الفريق (/teams/{team-id}/channels/...)
النشر مع المرفقات
التبديل بين حسابات الروبوت وحسابات المستخدمين
تنفيذ C++ كامل يشمل الحصول على الرمز

إذا كان لديك أي طلبات، فلا تتردد في ترك تعليق!

لقد جربت تثبيت حزمة إضافات Qt في Visual Studio Code

Fri, 13 Sep 2024 00:53:53 +0900

بدء تطوير Qt في VSCode: كيفية تثبيت حزمة إضافات Qt

مرحبًا، أنا Kenji. هذه المرة سأقدم “كيفية إعداد بيئة تطوير Qt في Visual Studio Code (والمعروف باسم VSCode)”.

في الآونة الأخيرة، بالإضافة إلى Qt Creator الرسمي، تزايدت الأصوات التي ترغب في تطوير تطبيقات Qt باستخدام VSCode خفيف الوزن وعالي القابلية للتوسيع. نوصي هؤلاء الأشخاص بـ ** “حزمة إضافات Qt” **. بمجرد تثبيت حزمة الإضافات هذه، ستتوفر لديك جميع الإضافات الرئيسية المتعلقة بـ Qt دفعة واحدة.

الجمهور المستهدف

أولئك الذين يرغبون في البدء في تطوير تطبيقات واجهة المستخدم الرسومية (GUI) باستخدام Qt
أولئك الذين يرغبون في التطوير باستخدام VSCode بدلاً من Qt Creator
أولئك الذين يجدون صعوبة في البحث عن الإضافات واحدة تلو الأخرى

المتطلبات الأساسية

أن يكون VSCode مثبتًا بالفعل (يمكنك تنزيله مجانًا من الموقع الرسمي)
أن تكون مكتبة Qt الأساسية مثبتة (موقع Qt الرسمي)

ما هي حزمة إضافات Qt؟

حزمة إضافات Qt هي حزمة إضافات لـ VSCode. من خلال تثبيتها، ستتم إضافة الميزات التالية تلقائيًا:

دعم ملفات .ui (Qt Designer)
تمييز بناء الجملة لملفات .pro وملفات .qrc
إكمال كود C++ لـ Qt، والبناء، ودعم تصحيح الأخطاء
متصفح موارد Qt (تصفح الموارد)

خطوات التثبيت

1. افتح VSCode

أولاً، قم بتشغيل VSCode.

2. افتح عرض الإضافات

انقر على شريط النشاط على اليسار (رمز المربع) لعرض “الإضافات”.

أو يمكنك الضغط على الاختصار Ctrl + Shift + X.

3. ابحث عن “Qt Extension Pack”

أدخل الكلمة الرئيسية التالية في شريط البحث:

1

Qt Extension Pack

4. انقر فوق زر التثبيت

بمجرد ظهور الحزمة المستهدفة، انقر فوق الزر “تثبيت”. سيؤدي هذا إلى تثبيت الإضافات المتعددة التالية دفعة واحدة:

Qt Language Support
QML Support
Qt Designer Integration
CMake Tools (مطلوب لتطوير Qt المتوافق مع CMake)

إضافة حول إعدادات المشروع (مثال CMake + Qt)

إذا كنت تستخدم Qt استنادًا إلى CMake، فنوصي بدمجه مع الإضافات التالية:

أيضًا، إذا أضفت الكود التالي إلى CMakeLists.txt، فسيكون التكامل مع Qt سلسًا:

1
2


find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(MyApp PRIVATE Qt6::Widgets)

مكافأة: كيف تفتح ملفات .ui؟

يمكن تحرير ملفات .ui في Qt Designer. في VSCode، يمكنك النقر بزر الماوس الأيمن على ملف .ui ثم اختيار Open with Qt Designer (يجب أن يكون Qt Designer مضمنًا في متغير البيئة PATH).

الخلاصة

الخطوة	الوصف
1	تشغيل VSCode
2	فتح لوحة الإضافات
3	البحث عن “Qt Extension Pack”
4	النقر فوق زر التثبيت

أصبح إعداد بيئة Qt في VSCode أسهل بكثير من ذي قبل. يحتوي على ميزات كافية ليكون بديلاً لـ Qt Creator، ونوصي به لأولئك الذين يرغبون في العمل بخفة.

مجموعة روابط موصى بها

أخيرًا

في المستقبل، أخطط لمواصلة التطوير باستخدام أدوات واجهة المستخدم لـ Qt و QML في هذه البيئة. في المرة القادمة، أخطط لشرح ** كيفية بناء وتشغيل تطبيق Hello World في Qt من VSCode **.

أراكم لاحقًا!

كيفية التراجع عن git reset

Wed, 15 May 2024 23:32:43 +0900

كيفية التراجع عن git reset

إذا قمت بتشغيل git reset عن طريق الخطأ بعد إجراء git commit، فإليك كيفية التراجع عن git reset (كيفية استعادة الحالة وقت إجراء git commit).

تحقق من معرف الالتزام (commit ID) قبل إعادة الضبط باستخدام git reflog
ارجع إلى الحالة قبل إعادة الضبط باستخدام git reset --hard HEAD@{number}

هذه كانت طريقة التراجع عن git reset.

الحصول على أحدث إصدار من مستودع git فقط

Sat, 27 Apr 2024 02:54:12 +0900

الحصول على أحدث إصدار من مستودع git فقط

يمكنك الحصول على أحدث إصدار من المستودع فقط باستخدام الأمر التالي. هذا مفيد إذا كنت ترغب في جلب المستودع بسرعة لتوفير مساحة القرص.

1

git clone --depth 1 <عنوان URL للمستودع>

مقدمة إلى Vim

Fri, 19 Apr 2024 22:06:34 +0900

مقدمة إلى Vim

التنزيل والتثبيت

https://www.vim.org/download.php

قم بتنزيل الوحدة وتثبيتها لنظام التشغيل الخاص بك من الموقع أعلاه.

بالنسبة لنظام التشغيل Windows، من الأفضل اختيار gvim_X.X.X_x64_signed.exe.

كيفية التشغيل

في حالة Windows، يجب تسجيل المجلد الذي يحتوي على vim.exe في مسار متغيرات البيئة Path.

طريقة التشغيل

1

vim

إذا كنت تريد التشغيل بتحديد اسم ملف

1

vim filename.txt

كيفية الخروج

للخروج، اكتب : (نقطتين)، ثم اكتب q، واضغط على Enter

1

:q

إذا قمت بتحديث الملف، فسيتم عرض لم يتم الحفظ منذ آخر تغيير (أضف ! للتجاوز). يمكنك تجاهل التغييرات والخروج بالقوة.

1

:q!

لحفظ الملف والخروج

1

:wq

التالي له نفس المعنى.

1

:x

يمكنك أيضًا الخروج بالضغط على z مرتين مع الاستمرار في الضغط على Shift. (نفس :wq)

الأوضاع

يحتوي Vim على وضع الأوامر ووضع الإدخال. عند تشغيل vim، سيكون في وضع الأوامر، وسيؤدي الضغط على مفتاح i إلى التبديل إلى وضع الإدخال.

في وضع الإدخال، يمكنك الكتابة كالمعتاد. للتبديل من وضع الإدخال إلى وضع الأوامر، اضغط على مفتاح ESC.

إن وجود تبديل الأوضاع هذا هو من خصائص Vim.

حركة المؤشر والتمرير

فيما يلي ملخص لحركة المؤشر والتمرير في وضع الأوامر.

المفتاح	الوصف
`h` (أو `Ctrl`+`H`، `BackSpace`، `←`)	الانتقال إلى اليسار
`j` (أو `Ctrl`+`J`، `N`، `↓`)	الانتقال إلى الأسفل
`k` (أو `Ctrl`+`P`، `↑`)	الانتقال إلى الأعلى
`l` (أو `Space`، `→`)	الانتقال إلى اليمين
`+` (أو `Enter`)	الانتقال إلى بداية السطر التالي
`-`	الانتقال إلى بداية السطر السابق
`Ctrl`+`B` (أو `PageUp`)	التمرير لأعلى
`Ctrl`+`F` (أو `PageDown`)	التمرير لأسفل
`Ctrl`+`U`	التمرير لأعلى نصف شاشة
`Ctrl`+`D`	التمرير لأسفل نصف شاشة
`Ctrl`+`Y`	التمرير لأعلى سطراً واحداً
`Ctrl`+`E`	التمرير لأسفل سطراً واحداً
`z` `Enter`	تمرير سطر المؤشر إلى أعلى الشاشة
`z` `.`	تمرير سطر المؤشر إلى وسط الشاشة
`z` `-`	تمرير سطر المؤشر إلى أسفل الشاشة
`0` (أو `\|`)	نقل المؤشر إلى بداية السطر
`$`	نقل المؤشر إلى نهاية السطر
`^` (أو `_`)	نقل المؤشر إلى بداية السطر (باستثناء المسافات وعلامات الجدولة)
`G` (أو `:$`)	نقل المؤشر إلى السطر الأخير
`:رقم السطر` `Enter`	الانتقال إلى السطر المحدد

إذا قمت بإدخال مفاتيح الحركة أعلاه بعد رقم، فيمكنك الانتقال عدة مرات بمقدار ذلك الرقم. (على سبيل المثال، كتابة 3j ستنقلك 3 أسطر لأسفل من موضع المؤشر الحالي.)

أوامر أخرى

المفتاح	الوصف
`Ctrl`+`L`	إعادة رسم الشاشة
`Ctrl`+`G`	عرض عدد أسطر الملف بأكمله، وموضع المؤشر، وما إلى ذلك

قائمة اختصارات Microsoft Word

Sun, 07 Apr 2024 14:18:51 +0900

قائمة الاختصارات

مفتاح الاختصار	الوصف
`Ctrl` + `B`	غامق
`Ctrl` + `I`	مائل
`Ctrl` + `U`	تسطير
`Ctrl` + `E`	محاذاة للوسط
`Ctrl` + `L`	محاذاة لليسار
`Ctrl` + `R`	محاذاة لليمين
`Ctrl` + `]`	تكبير حجم الخط
`Ctrl` + `[`	تصغير حجم الخط
`Ctrl` + `C`	نسخ
`Ctrl` + `V`	لصق
`Ctrl` + `X`	قص
`Ctrl` + `Z`	تراجع
`Ctrl` + `Y`	إعادة
`Ctrl` + `A`	تحديد الكل
`Shift` + `مفاتيح الأسهم`	تحديد النطاق
`Ctrl` + `F`	البحث عن نص
`Ctrl` + `H`	استبدال نص
`Ctrl` + `P`	معاينة الطباعة
`Ctrl` + `S`	حفظ المستند
`F12`	حفظ باسم
`Ctrl` + `Home`	الانتقال إلى بداية المستند
`Ctrl` + `End`	الانتقال إلى نهاية المستند

مرجع

اختصارات لوحة المفاتيح في Word

إضافة Hidemaru Editor grep إلى قائمة النقر بزر الماوس الأيمن في مستكشف الملفات

Wed, 03 Apr 2024 00:00:46 +0900

نقدم لكم طريقة لإضافة grep الخاص بـ Hidemaru Editor إلى قائمة النقر بزر الماوس الأيمن في مستكشف الملفات في Windows 10/11.

※ يرجى ملاحظة أن الخطوات التالية تتضمن تعديل السجل (الريجستري)، لذا يرجى القيام بذلك على مسؤوليتك الخاصة.

الخطوات

افتح الرابط التالي واحفظ الملف في أي مجلد تريده.

تسجيل_ريجستري_هيديمارو.reg

انقر نقراً مزدوجاً على ملف تسجيل_ريجستري_هيديمارو.reg لإضافته إلى السجل.

المراجع

تنفيذ Hidemaru grep من قائمة النقر بزر الماوس الأيمن للمجلد

كيفية إصلاح خطأ 'Temporary failure resolving...' في WSL

Sun, 31 Mar 2024 16:57:33 +0900

كيفية إصلاح خطأ ‘Temporary failure resolving…’ في WSL

kenji@MyComputer:~$ sudo apt update [sudo] password for kenji: Err:1 http://archive.ubuntu.com/ubuntu focal InRelease Temporary failure resolving 'archive.ubuntu.com'

عند ظهور الخطأ أعلاه في WSL، قد يكون إعداد خادم DNS غير صحيح. في بيئتي، تم حل المشكلة باتباع الخطوات التالية:

قم بتشغيل WSL.
قم بتنفيذ sudo nano /etc/resolv.conf.
قم بتغيير سطر nameserver إلى ما يلي: nameserver 8.8.8.8
احفظ باستخدام Ctrl + S واخرج باستخدام Ctrl + X.
قم بتنفيذ sudo apt update.
إذا لم يظهر الخطأ، فقد تم الحل.

إذا لم تحل الخطوات أعلاه المشكلة

يبدو أن الخطوات أعلاه قد لا تحل المشكلة في بعض الحالات. يرجى الرجوع إلى المقال التالي.

كيفية حل ‘Temporary failure resolving…’ عند تحديث apt في WSL

تثبيت PowerToys من موجه الأوامر

Sat, 30 Sep 2023 21:23:00 +0900

تثبيت PowerToys من موجه الأوامر

إليك كيفية تثبيت PowerToys من موجه الأوامر.

1

winget install Microsoft.PowerToys --source winget

إلغاء تثبيت PowerToys من موجه الأوامر

1

winget uninstall --name PowerToys

حول جائزة Microsoft MVP (2023-2024)

Mon, 31 Jul 2023 19:15:14 +0900

حول جائزة Microsoft MVP (2023-2024)

لقد حصلت مؤخرًا على جائزة Microsoft MVP (2023-2024). هذا هو العام السابع على التوالي منذ عام 2017 الذي أحصل فيه على هذه الجائزة.

الفئة التي فزت بها هي Developer Technologies .

بالنظر إلى أنشطتي السابقة، فقد قمت بما يلي:

نشر الكود على GitHub
مشاركة المعلومات التقنية على المدونة و وسائل التواصل الاجتماعي (مثل Twitter)
النشر في منتدى MSDN
تقديم ملاحظات حول منتجات مايكروسوفت

سأستمر في كتابة مقالات أفضل ومشاركة المعلومات في المستقبل.

شكرا جزيلا لكم.

البحث عن رعاة على GitHub

Tue, 17 Jan 2023 18:13:56 +0900

البحث عن رعاة على GitHub

سأكون سعيداً إذا أصبحت راعياً على GitHub من خلال الزر أدناه.

سأستخدمه في تطوير الأدوات وغيرها.

سأبذل قصارى جهدي حتى أتمكن من الحصول على شهادة توقيع الرمز!

محرر الرسوم البيانية

Thu, 13 Oct 2022 23:31:11 +0900

محرر الرسوم البيانية

هذه مقدمة لصفحة ويب تتيح لك إنشاء رسوم بيانية بسيطة.

https://csacademy.com/app/graph_editor/

يمكنك إنشاء رسوم بيانية عن طريق إدخال القيم الرقمية. بالإضافة إلى ذلك، يبدو أنه يمكنك أيضًا تحريك العناصر باستخدام الماوس.

من خلال النقر على Directed، يمكنك أيضًا إنشاء رسوم بيانية موجهة.

يمكنك حفظ الرسوم البيانية التي قمت بإنشائها أو الرسوم البيانية التي تم إنشاؤها عبر Download as PNG كصور.