Bower



bower

API

الأوامر

مرجع سطر الأوامر

مخبأ

$ bower cache <command> [<args>]

إدارة مخزن باور كاش

مخبأ نظيف

$ bower cache clean
$ bower cache clean <name> [<name> ...]
$ bower cache clean <name>#<version> [<name>#<version> ..]

ينظف الحزم المخزنة مؤقتًا

قائمة مخبأ

$ bower cache list
$ bower cache list <name> [<name> ...]

يسرد الحزم المخزنة مؤقتًا

مساعدة

$ bower help <command>

عرض معلومات المساعدة حول Bower

الصفحة الرئيسية

$ bower home
$ bower home <package>
$ bower home <package>#<version>

يفتح صفحة الحزمة الرئيسية في المتصفح المفضل لديك.

إذا لم يتم تمرير <package> ، فافتح الصفحة الرئيسية للحزمة المحلية.

معلومات

$ bower info <package>
$ bower info <package> [<property>]
$ bower info <package>#<version> [<property>]

يعرض المعلومات الشاملة لحزمة أو إصدار معين.

فيه

$ bower init

بشكل تعاوني إنشاء ملف bower.json

التثبت

$ bower install [<options>]
$ bower install <endpoint> [<endpoint> ..] [<options>]

تثبيت تبعيات المشروع بشكل متكرر.

تتكون تبعيات المشروع من:

  1. dependencies المحددة في bower.json للمشروع
  2. جميع التبعيات "الخارجية" غير المحددة في bower.json ، ولكنها موجودة في bower_components
  3. يتم تمرير أي <endpoint> إضافية <endpoint> كوسيطة لهذا الأمر

عند استخدام --save ، يتم حفظ كل نقطة النهاية الإضافية في dependencies في bower.json .

توصي Bower أن تستخدم دائما - --save العلم لتحقيق تثبيت استنساخه بين الآلات.

يمكن أن تحتوي نقاط النهاية على عدة أشكال:

  • <package>
  • <package>#<version>
  • <name>=<package>#<version>

أين:

  • <package> هو عنوان URL لحزمة أو موقع فعلي أو اسم تسجيل
  • <version> هو نطاق صالح ، ارتكاب ، فرع ، إلخ.
  • <name> هو الاسم الذي يجب أن يكون عليه محليًا.

يمكن أن يكون <package> أحد ما يلي:

اسم الحزمة المسجلة jquery
normalize.css
نقطة النهاية Git https://github.com/user/package.git
[email protected] :user/package.git
نقطة النهاية دون بدون git+https://github.com/user/package
git+ssh:// [email protected] /user/package
مجلد محلي my/local/folder/
نقطة النهاية التخريب العامة svn+http://package.googlecode.com/svn/
نقطة النهاية التخريب الخاصة svn+ssh://package.googlecode.com/svn/
svn+https://package.googlecode.com/svn/
الاختزال (الافتراضيات إلى GitHub) user/package
URL http://example.com/script.js
http://example.com/style.css
http://example.com/package.zip (سيتم استخراج المحتويات)
http://example.com/package.tar (سيتم استخراج المحتويات)

يمكن أن يكون الإصدار:

نسخة المقسم #1.2.3
نطاق الإصدار #1.2
#~1.2.3
#^1.2.3
#>=1.2.3 <2.0
علامة جيت #<tag>
Git ارتكاب SHA #<sha>
فرع جيت #<branch>
مراجعة التخريب #<revision>

خيارات التثبيت

  • -F ، --force-latest : --force-latest أحدث إصدار على الصراع
  • -p ، --production : لا تقم بتثبيت devDependencies المشروع
  • -S ، - --save : حفظ الحزم المثبتة في تبعيات bower.json للمشروع
  • -D ، --save-dev : قم بحفظ الحزم المثبتة في bord.json devDependencies الخاص بالمشروع
  • -E ، --save-exact : قم بتكوين الحزم المثبتة بإصدار محدد بدلاً من semver
$ bower link
$ bower link <name> [<local name>]

تتيح وظيفة الارتباط للمطورين اختبار حزمهم بسهولة. الربط هو عملية من خطوتين.

سيؤدي استخدام "bower link" في مجلد مشروع إلى إنشاء رابط عام. بعد ذلك ، في بعض الحزم الأخرى ، سيقوم bower link <name> بإنشاء ارتباط في مجلد المكونات يشير إلى الارتباط الذي تم إنشاؤه مسبقًا.

يتيح لك ذلك اختبار الحزمة بسهولة لأن التغييرات ستنعكس على الفور. عندما لا يعود الرابط ضروريًا ، قم بإزالته ببساطة مع bower uninstall <name> .

قائمة

$ bower list [<options>]

قائمة الحزم المحلية والتحديثات الممكنة.

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

  • -p ، --paths : إنشاء مخطط مصدر JSON بسيط
  • -r ، --relative : إنشاء مسارات ذات صلة بخاصية تكوين الدليل ، والتي يتم تعيينها بشكل افتراضي إلى bower_components

ابحث عن

$ bower lookup <name>

ابحث عن عنوان حزمة الحزمة بالاسم

تسجيل الدخول

$ bower login

المصادقة مع جيثب وتخزين بيانات الاعتماد. مطلوب لإلغاء تسجيل الحزم.

خيارات تسجيل الدخول

  • -t ، --token : تمرير رمز GitHub auth موجود بدلاً من المطالبة باسم المستخدم وكلمة المرور

تقليم

$ bower prune

يزيل الحزم الدخيلة المحلية

تسجيل

$ bower register <name> <url>

تسجيل حزمة

$ bower search
$ bower search <name>

يجد كل الحزم أو حزمة محددة.

تحديث

$ bower update <name> [<name> ..] [<options>]

تحديثات الحزم المثبتة على أحدث إصدار وفقا ل bower.json.

خيارات التحديث

  • -F ، --force-latest : --force-latest أحدث إصدار على الصراع
  • -p ، --production : لا تقم بتثبيت devDependencies المشروع
  • -S ، --save : تحديث dependencies في bower.json
  • -D ، --save-dev : تحديث devDependencies في bower.json

الغاء التثبيت

$ bower uninstall <name> [<name> ..] [<options>]

يقوم بإلغاء تثبيت حزمة محليًا من دليل bower_components الخاص بك

خيارات إلغاء التثبيت

  • -S ، --save : قم بإزالة الحزم التي تم إلغاء تثبيتها من تبعيات bower.json للمشروع
  • -D ، --save-dev : قم بإزالة الحزم التي قمت بإزالتها من bower.json devDependencies الخاصة بالمشروع

إلغاء

$ bower unregister <package>

إلغاء تسجيل الحزمة.

الإصدار

$ bower version [<newversion> | major | minor | patch]

قم بتشغيل هذا في دليل الحزم لرفع النسخة وكتابة البيانات الجديدة مرة أخرى إلى ملف bower.json.

يجب أن تكون الوسيطة newversion عبارة عن سلسلة semver صالحة ، أو وسيطة ثانية صالحة لـ semver.inc (واحد من "build" أو "patch" أو "minor" أو "major"). في الحالة الثانية ، سيتم زيادة الإصدار الموجود بنسبة 1 في الحقل المحدد.

إذا تم تشغيله في git repo ، فسوف ينشئ أيضًا التزامًا وعلامة إصدار ، ويفشل إذا كان repo غير نظيف.

خيارات الإصدار

  • -m ، --message : custom git commit and tag message

إذا تم تزويد --message (الاختزال: -m ) ، --message كرسالة التزام عند إنشاء نسخة. إذا احتوى تهيئة الرسالة على٪ s ، فسيتم استبدال ذلك برقم الإصدار الناتج. فمثلا:

$ bower version patch -m "Upgrade to %s for reasons"

خيارات

فرض

-f, --force

يجعل أوامر مختلفة أكثر قوة

  • bower install --force re-installs all installed components. كما يفرض التثبيت حتى عندما يكون هناك دلائل غير bower مع نفس الاسم في دليل المكونات. إضافة --force أيضا يتجاوز ذاكرة التخزين المؤقت ، ويكتب إلى ذاكرة التخزين المؤقت على أي حال.
  • bower uninstall <package> --force continue bower uninstall <package> --force uninstallation even even after a dependency conflict
  • bower register <package> --force and bower unregister <package> --force confirmation. لا يزال هناك حاجة لتسجيل الدخول.

سلمان

-j, --json

الناتج المستهلكة JSON

تسجيل مستوى

-l, --loglevel

ما مستوى السجلات للإبلاغ عنها. القيم المحتملة: خطأ أو تعارض أو تحذير أو إجراء أو معلومات أو تصحيح

غير متصل على الانترنت

-o, --offline

لا تستخدم اتصال الشبكة

هادئ

-q, --quiet

فقط إخراج المعلومات الهامة. إنه اسم مستعار لـ - --loglevel=warn .

صامت

-s, --silent

لا إخراج أي شيء ، إلى جانب الأخطاء. إنه اسم مستعار لـ - --loglevel=error . يكون الصامت مفيدًا أيضًا إذا كان لديك مكونات خاصة قد تؤدي إلى تسرب بيانات الاعتماد إلى بيئة CI الخاصة بك.

مطنب

-V, --verbose

يجعل الإخراج أكثر مطولاً. إنه اسم مستعار لـ - --loglevel=debug .

تسمح الجذر

--allow-root

يسمح بتشغيل الأوامر كجذر. Bower هو أمر مستخدم ، وليست هناك حاجة إلى تنفيذه بأذونات مستخدم متميز. ومع ذلك ، إذا كنت لا تزال ترغب في تشغيل الأوامر باستخدام sudo ، --allow-root خيار --allow-root .

تستهلك حزمة

يمكنك استخدام أدوات البناء لاستهلاك باور باور بسهولة.

إذا كنت تستخدم list أو bower list --paths --json ، bower list --paths --json على تعيين بسيط من اسم إلى مسار:

$ bower list --paths
# or
$ bower list --paths --json
{
  "backbone": "bower_components/backbone/backbone.js",
  "jquery": "bower_components/jquery/dist/jquery.js",
  "underscore": "bower_components/underscore/underscore.js"
}

كل أمر يدعم json الذي يجعل Bower output JSON. يتم إخراج نتيجة الأمر إلى stdout وخطأ / سجلات إلى stderr .

API برمجة

يوفر Bower API قوية وبرمجية. يمكن الوصول إلى كافة الأوامر من خلال كائن bower.commands .

var bower = require('bower');

bower.commands
.install(['jquery'], { save: true }, { /* custom config */ })
.on('end', function (installed) {
    console.log(installed);
});

bower.commands
.search('jquery', {})
.on('end', function (results) {
    console.log(results);
});

تصدر الأوامر أربعة أنواع من الأحداث: log ، prompt ، end ، error .

  • log المنبثق للإبلاغ عن حالة / تقدم الأمر.
  • يتم إرسال prompt كلما احتاج المستخدم إلى مطالبتك بذلك.
  • سوف ينطلق error فقط إذا حدث خطأ ما.
  • end الأمر عند انتهاء الأمر بنجاح.

للحصول على فكرة أفضل عن كيفية عمل ذلك ، قد ترغب في التحقق من ملف bin الخاص بنا .

عند استخدام Bower بطريقة برمجية ، يتم تعطيل المطالبة بشكل افتراضي. يمكنك تمكينه عند استدعاء الأوامر interactive: true في التهيئة. هذا يتطلب منك الاستماع إلى الحدث prompt والتعامل مع المطالبة بنفسك. أسهل طريقة هي استخدام وحدة npm للمراسلة مثل:

var inquirer =  require('inquirer');

bower.commands
.install(['jquery'], { save: true }, { interactive: true })
// ..
.on('prompt', function (prompts, callback) {
    inquirer.prompt(prompts).then(callback);
});

يعمل على خادم التكامل المستمر

سوف يتخطى Bower بعض العمليات التفاعلية إذا وجد متغير CI بيئيًا مضبوطًا على true . ستجد أن متغير CI محدد بالفعل لك على العديد من خوادم التكامل المستمر ، مثل CircleCI و Travis-CI .

يمكنك محاولة ضبط متغير CI يدويًا قبل تشغيل أوامر Bower. في نظامي Mac أو Linux ، فإن export CI=true وعلى Windows set CI=true

إذا كنت غير قادر ، لسبب ما ، على تعيين متغير بيئة CI ، فيمكنك استخدام علامة --config.interactive=false بالتناوب.

$ bower install --config.interactive=false

وضع غير تفاعلي

يعمل Bower بشكل افتراضي في الوضع التفاعلي. هناك طرق قليلة لتعطيله:

  • يمر CI=true في البيئة
  • تمرير --config.interactive=false إلى أمر Bower
  • توصيل أنبوب إلى Bower (على سبيل المثال ، bower install | cat )
  • إعادة توجيه الإخراج إلى ملف (على سبيل المثال ، bower install > logs.txt )
  • تشغيل Bower عبر API برمجة

عندما يتم تعطيل الوضع التفاعلي:

  • bower init لا يعمل
  • bower register و bower unregister bypass confirmation
  • فشل bower login إلا إذا تم توفير المعلمة --token
  • فشل bower install في حل النزاعات ، بدلاً من طلب الاختيار
  • لا تطلب bower uninstall تأكيدًا إذا تمت إزالة التبعية

باستخدام ذاكرة التخزين المؤقت المحلية

تدعم Bower تثبيت الحزم من ذاكرة التخزين المؤقت المحلية - بدون اتصال بالإنترنت - إذا تم تثبيت الحزم من قبل.

$ bower install <package> --offline

يمكن سرد محتويات ذاكرة التخزين المؤقت مع bower cache list :

$ bower cache list

يمكن تنظيف bower cache clean باستخدام bower cache clean :

$ bower cache clean