الفرق بين المراجعتين لصفحة: «Cordova/template»
جميل-بيلوني (نقاش | مساهمات) ط تعديل حجم الصور |
تحديث |
||
| سطر 11: | سطر 11: | ||
$ cordova create hello com.example.hello HelloWorld --template <git-remote-url> | $ cordova create hello com.example.hello HelloWorld --template <git-remote-url> | ||
$ cordova create hello com.example.hello HelloWorld --template <path-to-template> | $ cordova create hello com.example.hello HelloWorld --template <path-to-template> | ||
</syntaxhighlight>بعد استخدام قالب لإنشاء مشروعك بنجاح، ستحتاج إلى الإشارة إلى المنصات التي تنوي استهدافها باستخدام تطبيقك. اذهب إلى مجلد المشروع الخاص بك و<nowiki/>[[Cordova/first app#.D8.A5.D8.B6.D8.A7.D9.81.D8.A9 .D9.85.D9.86.D8.B5.D8.A7.D8.AA|أضف المنصات]]. | |||
</syntaxhighlight>بعد استخدام قالب لإنشاء مشروعك بنجاح، ستحتاج إلى الإشارة إلى المنصات التي تنوي استهدافها باستخدام تطبيقك. اذهب إلى مجلد المشروع الخاص بك | |||
== إنشاء قالب == | == إنشاء قالب == | ||
| سطر 22: | سطر 20: | ||
└── template_src/ (required) | └── template_src/ (required) | ||
└── CONTENTS OF APP TEMPLATE | └── CONTENTS OF APP TEMPLATE | ||
</syntaxhighlight>عندما يتم استخدام القالب الخاص بك، سيتم استخدام جميع المحتويات الموجودة داخل المجلد template_src لإنشاء المشروع الجديد، لذا تأكد من تضمين أي ملفات ضرورية في هذا المجلد. قم بمراجعة [https://github.com/apache/cordova-template-reference هذا المثال] للحصول على التفاصيل. | </syntaxhighlight>عندما يتم استخدام القالب الخاص بك، سيتم استخدام جميع المحتويات الموجودة داخل المجلد <code>template_src</code> لإنشاء المشروع الجديد، لذا تأكد من تضمين أي ملفات ضرورية في هذا المجلد. قم بمراجعة [https://github.com/apache/cordova-template-reference هذا المثال] للحصول على التفاصيل. | ||
'''ملاحظة''': يجب أن يصدر الملف index.js مرجعًا إلى template_src ويجب أن يشير الملف package.json إلى index.js. اطلع على [https://github.com/carynbear/cordova-template هذا المثال] للحصول على تفاصيل حول كيفية القيام بذلك. | '''ملاحظة''': يجب أن يصدر الملف <code>index.js</code> مرجعًا إلى <code>template_src</code> ويجب أن يشير الملف <code>package.json</code> إلى <code>index.js</code>. اطلع على [https://github.com/carynbear/cordova-template هذا المثال] للحصول على تفاصيل حول كيفية القيام بذلك. | ||
لإنهاء القالب الخاص بك، قم بتعديل package.json وضع فيه الكلمة المفتاحية "cordova: template".<syntaxhighlight lang="shell"> | لإنهاء القالب الخاص بك، قم بتعديل <code>package.json</code> وضع فيه الكلمة المفتاحية "<code>cordova: template</code>".<syntaxhighlight lang="shell"> | ||
{ | { | ||
... | ... | ||
المراجعة الحالية بتاريخ 11:10، 29 نوفمبر 2020
تتيح لك القوالب استخدام شيفرة برمجية موجودة مسبقًا لتبني عليها مشروعك.
استخدام قالب
ابحث عن قالب لإنشاء تطبيقك من خلال البحث عن الكلمة المفتاحية cordova:template على npm. يمكنك أيضًا استخدام القوالب المحلية على حاسوبك الخاص، أو من مستودع Git.
بعد تحديد موقع القالب الذي ترغب في استخدامه، أنشئ مشروعك باستخدام هذا القالب، عن طريق تحديد الراية --template أثناء استعمال الأمر create متبوعًا بمصدر ذلك القالب.
إن أردت إنشاء مشروع كوردوفا من حزمة NPM أو مستودع Git أو المسار المحلي، فاستعمل إحدى الأوامر التالية:
$ cordova create hello com.example.hello HelloWorld --template <npm-package-name>
$ cordova create hello com.example.hello HelloWorld --template <git-remote-url>
$ cordova create hello com.example.hello HelloWorld --template <path-to-template>
بعد استخدام قالب لإنشاء مشروعك بنجاح، ستحتاج إلى الإشارة إلى المنصات التي تنوي استهدافها باستخدام تطبيقك. اذهب إلى مجلد المشروع الخاص بك وأضف المنصات.
إنشاء قالب
ابدأ بإنشاء تطبيق كوردوفا الذي سيصبح أساس القالب الخاص بك. ستأخذ بعد ذلك محتويات تطبيقك وتضعها في البنية التالية:
template_package/
├── package.json (optional; needed to publish template on npm)
├── index.js (required)
└── template_src/ (required)
└── CONTENTS OF APP TEMPLATE
عندما يتم استخدام القالب الخاص بك، سيتم استخدام جميع المحتويات الموجودة داخل المجلد template_src لإنشاء المشروع الجديد، لذا تأكد من تضمين أي ملفات ضرورية في هذا المجلد. قم بمراجعة هذا المثال للحصول على التفاصيل.
ملاحظة: يجب أن يصدر الملف index.js مرجعًا إلى template_src ويجب أن يشير الملف package.json إلى index.js. اطلع على هذا المثال للحصول على تفاصيل حول كيفية القيام بذلك.
لإنهاء القالب الخاص بك، قم بتعديل package.json وضع فيه الكلمة المفتاحية "cordova: template".
{
...
"keywords": [
"ecosystem:cordova",
"cordova:template"
]
...
}
مبارك! لقد أنشأت أول قالب خاص بك في كوردوفا. يمكنك مشاركة هذا القالب على npm بحيث يمكن للجميع الاستفادة من عملك الشاق.