> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# الترقية إلى v0.3.0

يستهدف هذا الدليل **Agent Java SDK `v0.3.0`** وJava 8+.

## قرر ما الذي يحتاج إلى الترقية

| التكامل القائم                           | فعل                                                                                    |
| ---------------------------------------- | -------------------------------------------------------------------------------------- |
| وظائف الإنتاج الحالية مع البيئة المحذوفة | تظل أشكال الاستجابة الحالية متوافقة؛ الاستعلامات الجديدة لا تفرض الترقية.              |
| توجد مصادقة تضمين عامة لتداول الثواني    | إعادة استخدام المصادقة والتجديد؛ حدد صفحة المنتج المطلوبة.                             |
| أرصدة التمويل والتحويلات والاسترداد      | استخدم النماذج التي تحتوي على `withFunding`، `walletTransfer` و `queryWalletTransfer`. |
| أموال محاكاة صريحة                       | استخدم نماذج الطلب/الاستجابة التي تدعم `environment`.                                  |
| ستة استعلامات البيانات الدائمة           | استخدم Java SDK `v0.3.0` العامة، بما في ذلك الطرق الستة ودعم توقيع المصفوفة.           |

احتفظ بارتباطات المستخدم الحالية `baseUrl`، `agentCode`، `apiSecret`، وأوامر العمل الأصلية.

## قم بتثبيت العلامة العامة الثابتة

يستضيف GitHub المصدر. لا يؤدي نشر علامة GitHub إلى نشر إحداثيات Maven إلى Maven Central. قم بتثبيت المصدر المميز محليًا أو انشر JAR/POM الذي تم التحقق منه إلى مستودع العناصر الخاص بمؤسستك.

```bash
git clone --branch v0.3.0 --single-branch https://github.com/6mm-com/agent-java-sdk.git agent-java-sdk-v0.3.0
cd agent-java-sdk-v0.3.0
git rev-parse HEAD
git rev-parse 'v0.3.0^{commit}'
mvn install
```

يجب أن يتطابق معرفا الالتزام. أعلن التبعية في المشروع الشريك:

```xml
<dependency>
    <groupId>com.sixmm.exchange.sdk</groupId>
    <artifactId>agent</artifactId>
    <version>0.3.0</version>
</dependency>
```

التحقق من التبعية التي تم حلها:

```bash
mvn dependency:tree -Dincludes=com.sixmm.exchange.sdk:agent
```

التثبيت المحلي يجعل القطعة الأثرية متاحة على هذا الجهاز فقط. يحتاج CI والمطورون الآخرون إلى نفس التثبيت الموسوم أو مستودع العناصر الذي تم التحقق منه. إذا كان لديك بالفعل قطعة أثرية خاصة باسم `0.3.0`، فتحقق من مصدرها وطرقها؛ لا تقم بالكتابة بصمت فوق قطعة أثرية مشتركة.

## تغييرات التكامل المطلوبة

1. تحديث نماذج الطلب والاستجابة الصريحة `environment`. قد ترفض نماذج الاستجابة القديمة الصارمة الحقل الإضافي.
2. استخدم `withFunding()` قبل قراءة `funding`. أرصدة العقود ليست أرصدة تداول ثانية.
3. استخدم `/v1/agent/wallet-transfer` و`/v1/agent/wallet-transfer-status` للتمويل. لا يمكن لـ `queryOrder` القديم استرداد عملية التمويل.
4. تستخدم الاستعلامات الستة `platformUserIds` كمصفوفة سلسلة. قم بتوقيع المصفوفات على أنها مضغوطة JSON؛ Java `List.toString()` غير متوافق.
5. قم بتخزين أوامر النقل وأوامر التداول العادية والأوامر المشروطة والتنفيذات ككيانات متميزة. قم بتحليل `orderStatus` أو `status` وفقًا للعملية.
6. تحقق من النص الأصلي webhook قبل التحليل. تتضمن الإشعارات المحاكاة الصريحة `environment`؛ قارنه بالأمر المحفوظ.
7. إدارة إصدارات Java والأدوات بشكل مستقل. لا تؤدي ترقية الواجهة الخلفية إلى تغيير الصفحة الأمامية أو وضع التداول، ولا يتطلب تداول الثواني نوع رمز مميز جديد.

## التحقق من الترقية

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

بالنسبة لعميل HTTP المخصص، اتبع الطلب الموسوم وعقد التوقيع بدلاً من افتراض أن النماذج القديمة تغطي الحقول الجديدة. يرى [قواعد توقيع الوكيل](/ar/sdk/security/secrets-signing#signing-rule), [نظرة عامة على الاستعلام](/ar/sdk/agent-sdk/java/perpetual-queries) و [دليل البيئة](/ar/sdk/agent-sdk/java/environments).

## المصدر والأدلة ذات الصلة

* [المصدر الرسمي v0.3.0](https://github.com/6mm-com/agent-java-sdk/tree/54aa3c1)
* [نظرة عامة على الاستعلام وترقيم الصفحات](/ar/sdk/agent-sdk/java/perpetual-queries)
* [محفظة التمويل](/ar/sdk/agent-sdk/java/funding-wallet)