مكتبة bitcoinj هي تطبيق Java لبروتوكول Bitcoin، مما يسمح لها بالحفاظ على المحفظة وإرسال/استقبال المعاملات دون الحاجة إلى نسخة محلية من Bitcoin Core. يأتي مزودًا بالوثائق الكاملة وبعض الأمثلة على التطبيقات التي توضح كيفية استخدامه.
Java 8+ (يحتاج إلى Java 8 API أو Android 8.0 API، ويتم تجميعه إلى Java 8 bytecode) للوحدة base
core
Java 17+ tools
wallettool
examples
ونموذج wallettemplate
المستند إلى JavaFX
جرادل
Gradle 7.3+ لبناء المشروع بأكمله أو
Debian Gradle 4.4 للوحدات base
core
tools
وأدوات wallettool
examples
فقط (راجع "الإنشاء المرجعي" أدناه)
مخازن بروتوكول Google المؤقتة - للاستخدام مع التسلسل واتصالات الأجهزة
للبدء، من الأفضل تثبيت أحدث إصدار من JDK وGradle. يحتوي رأس الفرع master
على أحدث كود التطوير ويتم توفير إصدارات إنتاج متنوعة في الفروع المميزة.
تستخدم الإصدارات الرسمية حاليًا JDK 17. يتم إنشاء إجراءات GitHub واختبارها باستخدام JDK 17 و21.
gradle clean build
المخرجات موجودة ضمن دليل build
.
لإجراء بناء كامل بدون اختبارات الوحدة/التكامل، استخدم:
gradle clean assemble
وبدلاً من ذلك، ما عليك سوى استيراد المشروع باستخدام IDE الخاص بك. يحتوي IntelliJ على تكامل Gradle مدمج ولديه إصدار مجتمعي مجاني. ببساطة استخدم File | New | Project from Existing Sources
وحدد build.gradle
في جذر شجرة مصدر المشروع المستنسخة.
يتضمن المشروع الفرعي bitcoinj wallettool
أداة Wallet Tool ( wallet-tool
) لسطر الأوامر والتي يمكن استخدامها لإنشاء وإدارة المحافظ المستندة إلى bitcoinj (كل من سلسلة المفاتيح HD وحالة blockchain SPV.) يعد استخدام wallet-tool
على شبكة اختبار Bitcoin أمرًا رائعًا طريقة للتعرف على Bitcoin و bitcoinj .
لإنشاء برنامج نصي قابل للتنفيذ يقوم بتشغيل أداة Wallet Tool ذات سطر الأوامر، استخدم:
gradle bitcoinj-wallettool:installDist
يمكنك الآن تشغيل wallet-tool
بدون معلمات للحصول على المساعدة في تشغيلها:
./wallettool/build/install/wallet-tool/bin/wallet-tool
لإنشاء ملف محفظة شبكة اختبارية في ~/bitcoinj/bitcoinj-test.wallet
، يمكنك استخدام:
mkdir ~/bitcoinj
./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet create
لمزامنة المحفظة التي تم إنشاؤها حديثًا في ~/bitcoinj/bitcoinj-test.wallet
مع شبكة الاختبار، يمكنك استخدام:
./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet sync
لتفريغ حالة المحفظة في ~/bitcoinj/bitcoinj-test.wallet
مع شبكة الاختبار، يمكنك استخدام:
./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet dump
ملحوظة | هذه التعليمات مخصصة لنظام التشغيل macOS/Linux، أما بالنسبة لنظام التشغيل Windows، فاستخدم الملف الدفعي wallettool/build/install/wallet-tool/bin/wallet-tool.bat مع أوامر وخيارات سطر أوامر Windows المكافئة. |
يتم تشغيل الإصدار المرجعي الخاص بنا (والذي يُستخدم أيضًا في إصداراتنا) داخل حاوية لتوفير إمكانية تكرار نتائج جيدة. يتم دعم الإصدار 1.26+ من Buildah، وPodman 4.1+، وDocker (مع BuildKit). لقد اختبرنا مجموعات مختلفة من أنظمة تشغيل المضيف (Debian، وUbuntu، وmacOS، وWindows+WSL) والبنيات (amd64، وarm64). للحصول على تعليمات الاستخدام، راجع build.Containerfile
.
يستخدم هذا Debian Gradle مع settings-debian.gradle
. إذا كنت تستخدم Debian وقمت بتثبيت Gradle من مستودع Debian، فيمكنك استدعاء هذه الإعدادات مباشرة:
gradle --settings-file settings-debian.gradle clean build
تم العثور على هذه في وحدة examples
.
أنت الآن جاهز لمتابعة البرنامج التعليمي.
تمت تغطية إنشاء التطبيقات باستخدام الإصدارات الرسمية من bitcoinj في البرنامج التعليمي.
إذا كنت ترغب في تطوير تطبيقك أو اختباره باستخدام إصدار مدعوم من Jitpack لأحدث إصدار master
أو فرع release-0.17
من bitcoinj، فاتبع التعليمات التي تم إنشاؤها ديناميكيًا لهذا الفرع باتباع الرابط الصحيح.
الفرع الرئيسي
الإصدار-0.17 فرع