استاندارد تقسیم بندی و نام گذاری فایلهای کتابخانه
با سلام .
معمولا کتابخانه هایی رو که در اختیار دیگران میگزارم ، یک تعدادی فایل داره که به شیوه ی خاصی اونا رو نام گزاری کردم .
برای یک تعدادی از فایلها نام ها دو قسمتی هستند . و دوتا ( یا تحت شرایطی شاید بیشتر از دوتا ) فایل هستند که نام تک قسمتی دارند .
قبل از اینکه توضیحات بیشتری بدم لطفا یک مثال از این نامگذاری ها رو در تصویر زیر ببینید .
این تصویر مربوط به فایلهای کتابخانه منو هست .
همانطور که در تصویر میبینید ، نام فایلها یک قسمت مشترک دارد که menu_4pin هست . که در واقع همان نام کتابخانه است.
نام بعضی از فایلها یک قسمت دوم دارد که با "_" از قسمت اول جداشده است .
که معنا و مفهوم آنها به شرح زیر است :
****************************************
****************************************
فایهایی که نامشان قسمت دوم ندارد:
مثال این نوع فایلها در تصویر بالا فایلهای menu_4pin.h و menu_4pin.c هستند .
این فایلها شامل تعریف و بدنه توابع کتابخانه به همراه تعریف متغیرهای سراسری کتابخانه و تعریف ماکروهای مورد اتستفاده کتابخانه است .
****************************************
****************************************
توضیحات قسمت دوم نامها :
**************************
1- conf :
این فایل به صورت h. است و تنظیمات کتابخانه منو به صورت ماکرو در این فایل قرار دارد و بوسیله آنها میتوان کتابخانه را در وضعیت خاصی قرار داد . ( مثلا حالت کم حجم تر یا سریعتر یا بعضی امکانات را فعال و غیر فعال کرد .)
**************************
2- link :
کتابخانه نیاز به توابع یا برونسپاری هایی دارد که ارتباطی به کتابخانه مورد نظر ندارد . این موارد از طریق معرفی در این فایل در دسترس کتابخانه منو قرار میگیرد.
مانند تابعی برای ایجاد تاخیر که HAL_Delay() یک نمونه آن است یا تابعی برای دسترسی به مقدار فعلی تایم بیس که HAL_GetTick() یک نمونه از آن است .
**************************
3- names:
این فایل شامل تعریف نامهایی است که برای راحتی کاربر به منظور استفاده در فایل conf منظور شده است .
**************************
4- typedef :
در این فایل تعاریف مربوط به انواع داده( شامل ساختمانها و یونیونها ، انواعی شمارشی و غیره ....) مورد استفاده کتابخانه قرار دارد .
**************************
5 - color :
در این فایل همانطور که از نامش پیداست کدهای مربوط به رنگ مورد استفاده کتابخانه در آن قرار دارد .( lcd ها کد رنگ دارند)
**************************
6- command :
این فایل تعاریف ( به صورت اسم ) مربوط به کدهای فرمان کتابخانه را در خود جای داده است ( معمولا این فایل برای سخت افزار ها مانند lcd ها وجود دارد )
**************************
** توجه :
بعضی کتابخانه ها ممکنه یک تعدادی از این فایلها را نداشته باشند .
****************************************
****************************************
مطلب در اینجا به پایان رسید .
با سپاس از توجه تان.