انتشار کدها بعنوان کتابخانه

یکی از ویژگی های خوب IDE آردوینو رنگی کردن کدها است. یعنی نام کلاس ها، نام تابع ها و متغیرها و غیره هرکدام رنگ های متفاوتی در ادیتور دارند. این کار باعث می شود خواندن سورس کدها بسیار ساده تر شود و این امکان وجود دارد تا برای کتابخانه ها(libraries) نیز سینتکس را رنگی کنیم. برای انجام این کار، کافیست یک فایل به نام keywords.txt را به پروژه ی خود اضافه کنیم:

# Syntax-coloring for the telegraph library

Telegraph	KEYWORD1
send_message	KEYWORD2

 خط های خالی و خط هایی که با علامت # شروع می شوند، نادیده گرفته خواهند شد. خط های باقی مانده، حاوی نام یکی از کتابخانه های عضو و نوع آن عضو است. نام کتابخانه و نوع(type) کتابخانه ها با دو کاراکتر تب(tab) از یکدیگر جدا شده اند. کلاس ها از نوع KEYWORD1 استفاده می کنند و تابع ها از نوع KEYWORD2 استفاده می کنند. برای ثابت ها، می توانید از نوع LITERAL1 استفاده کنید. برای فعال کردن سینتکس های رنگی برای کتابخانه ی telegraph، کافیست فایل keywords.txt را در فولدر libraries/Telegraph کپی کنید و IDE آردوینو را ریست کنید. اکنون نام کلاس Telegraph نارنجی خواهد شد و send_message به رنگ قهوه ای در خواهد آمد.

قبل از اینکه کتابخانه ی خود را منتشر کنید، باید چند چیز را به آن اضافه کنید:

• تمام اسکچ های مثالی را در یک فولدر به نام examples قرار دهید و آن را در فولدر libraries/Telegraph قرار دهید.
• تمام اسکچ های مثالی باید در داخل یک زیر پوشه در داخل پوشه ی مذکور قرار گیرند.
• برای پروژه ی خود یک لایسنس انتخاب کنید و این  قوانین را در داخل فایلی به نام LICENSE قرار دهید.
• دستور العمل های نصب و مستندات برنامه را اضافه کنید. معمولا کاربران انتظار دارند که مستندات را در فایلی به نام README مشاهده کنند و دستورالعمل های نصب را در فایلی به نام INSTALL ببینند. شما باید سعی کنید کتابخانه ی خود را بر روی چندین سیستم عامل نصب کنید و برای هرکدام از آنها دستور العمل های نصب را بنویسید.
• پروژه ی خود را در گیتهاب،  گوگل کد(Google Code) یا دیگر سایت های مشهوری که پروژه های اپن سورس را نگهداری می کنند قرار دهید.در این صورت دیگران می توانند به سادگی در پروژه ی شما مشارکت کنند.

پس از اینکه همه ی این مراحل را انجام دادید، فولدر libraries/Telegraph باید به صورت زیر باشد:

 در نهایت یک فایل زیپ ایجاد کنید که تمام این فایل های پروژه را دربر بگیرد. در اکثر سیستم عامل ها، می توانید در داخل Explorer  یا Finder یا دیگر مکان ها، بر روی فولدر پروژه راست کلیک کنید و بر روی دکمه ی مربوط به  زیپ کلیک کرده و این فولدر را به صورت زیپ در آورید. در سیستم های لینوکس و مک، ما همچنین می توانیم برای ایجاد یک فایل زیپ از فرمان های زیر در خط فرمان(commandline) استفاده کنیم:

maik> zip -r Telegraph Telegraph
maik> tar cfvz Telegraph.tar.gz Telegraph

 دستور اول در کدهای بالا، یک فایل به نام Telegraph.zip ایجاد می کند و دستور دوم Telegraph.tar.gz را ایجاد می کند. هر دوی این فرمت ها متداول هستند، و خوب است که هر دوی آنها را برای دانلود قرار دهیم. با اینکه ما هنوز باید بر روی فایل های خود کارهای زیادی را انجام دهیم، به سادگی می توانیم یک کتابخانه ی(library) آردوینو را ایجاد کنیم. بنابراین هر موقع که فکر کردید چیز خوبی ایجاد کرده اید می توانید آن را برای عموم منتشر کنید.

 توجه کنید که ساختار پروژه های کتابخانه در IDE آردوینو 1.5 و IDE های پس از آن کمی تغییر کرده است. بزرگترین تغییر، این است که تمام فایل های سورس کتابخانه  ( مثل telegraph.h و telegraph.cpp) باید در داخل یک فولدر جداگانه به نام src قرار گیرند. این مشخصات جدید از سازگاری عقبرو برخوردار است-یعنی کتابخانه های قدیمی هنوز هم  در IDE جدید کار می کنند.

 تا الآن پروژه ی ما با استفاده از ال ای دی ها (بیرونی) و دکمه های فشاری(درونی) توانسته است با جهان بیرونی ارتباط قرار کند. در فصل بعد، روش کار با قطعات داخلی پیچیده تر مثل سنسور فراصوت(ultrasonic) را آموزش خواهید دید. همچنین یاد خواهید گرفت که چگونه داده هایی که آردوینو به برنامه های در حال اجرای روی کامپیوتر ارسال می کند را مصور سازی(visualize data) کنید.

 {module کمک نقدی به نویسنده}