j2objc
ابزار j2objc فایل های منبع جاوا مشخص شده را برای استفاده در یک برنامه iOS به منابع Objective-C یا Objective-C++ ترجمه می کند.
j2objc [ options ] file1.java ...
گزینه های زیر پشتیبانی می شوند. برای گزینههایی که مسیری را طی میکنند، چندین فهرست و فایل jar با یک «:» از هم جدا میشوند، مانند دستورات java
و javac
.
گزینه های رایج
- -sourcepath <path>
- محل یافتن فایل های منبع ورودی را مشخص کنید.
- -classpath <path>
- محل پیدا کردن فایل های کلاس کاربر را مشخص کنید.
- -d <دایرکتوری>
- محل قرار دادن فایل های Objective-C تولید شده را مشخص کنید.
- -encoding <encoding>
- رمزگذاری کاراکتر فایل های منبع را مشخص کنید (پیش فرض UTF-8).
- منبع < -source >
- سازگاری منبع را با نسخه مشخص شده فراهم کنید.
- -g
- پشتیبانی از اشکال زدایی ایجاد کنید.
- -l, --list
- لیست فایل هایی که ترجمه شده اند.
- -v, --verbose
- خروجی پیام هایی درباره کاری که مترجم انجام می دهد.
- -Werror
- همه هشدارها را به خطا تبدیل کنید.
- -h, --help
- این پیام را چاپ کنید
گزینه های ترجمه
- --add-reads
- گزینه به طور مستقیم به کامپایلر جاوا ارسال می شود (برای جزئیات به راهنمای javac مراجعه کنید).
- --allow-inherited-constructors
- هنگامی که کد بومی به سازنده های به ارث رسیده دسترسی پیدا می کند، هشدارهای کامپایلر صادر نکنید.
- --build-closure
- کلاس های وابسته را اگر قدیمی هستند ترجمه کنید (مانند
javac
). - --class-properties
- ویژگی های کلاس را برای متغیرهای استاتیک و ثابت های enum ایجاد می کند.
- --dead-code-report <file>
- یک گزارش استفاده از ProGuard برای حذف کد مرده مشخص کنید.
- --doc-comments
- نظرات Javadoc را به نظرات سازگار با Xcode ترجمه کنید.
- --doc-comments-warnings
- هنگام ترجمه نظرات Javadoc هشدارها را گزارش دهید.
- -external-annotation-file <file>
- رایج ترین حاشیه نویسی هایی را که بر ترانویسی در یک فایل فهرست حاشیه نویسی جاوا تأثیر می گذارند (قالب تعریف شده توسط چارچوب جستجوگر) مشخص کنید.
- -g:none
- پشتیبانی از اشکال زدایی ایجاد نکنید.
- -g:relative
- پشتیبانی از اشکال زدایی را با مسیرهای نسبی ایجاد کنید.
- --generate-deprecated
- ویژگی های منسوخ شده برای متدها، کلاس ها و رابط های منسوخ شده تولید کنید.
- -J <پرچم>
- یک <flag> جاوا مانند
-Xmx1G
را به زمان اجرا سیستم ارسال کنید. - --mapping <file>
- یک فایل نگاشت روش اضافه کنید.
- --no-class-properties
- ویژگی های کلاس را برای متغیرهای استاتیک و ثابت های enum ایجاد نکنید.
- --no-extract-unsequenced
- عباراتی را بازنویسی نکنید که باعث ایجاد خطاهای اصلاحی بدون ترتیب می شود.
- --no-nullability
- حاشیه نویسی پوچ پذیر Objective-C ایجاد نکنید.
- --no-package-directories
- هنگام تولید فایل، دایرکتوری برای بسته های جاوا ایجاد نکنید.
- --no-segmented-headers
- هدرهایی با محافظ در اطراف هر نوع اعلام شده ایجاد می کند. برای شکستن چرخه های واردات مفید است.
- --no-wrapper-methods
- روشهای پوشش Objective-C را برای سازندهها و روشهای استاتیک تولید نکنید. (J2ObjC توابع C را برای این نوع فایل های اجرایی تولید می کند)
- --nullability
- حاشیه نویسی های Nullable و Nonnull را به حاشیه نویسی Objective-C تبدیل می کند.
- --patch-module
- گزینه به طور مستقیم به کامپایلر جاوا ارسال می شود (برای جزئیات به راهنمای javac مراجعه کنید).
- --prefix <package=prefix>
- یک پیشوند مشخص شده را جایگزین نام بسته کنید.
- --prefixes <file>
- یک فایل خواص را با تعاریف پیشوند مشخص کنید.
- --preserve-full-paths
- فایل های خروجی را با مسیرهای نسبی مشابه فایل های ورودی تولید می کند.
- -processor <class1>[,<class2>...]
- نام پردازنده های حاشیه نویسی برای اجرا. فرآیند کشف پیش فرض را دور می زند.
- -processorpath <path>
- محل پیدا کردن پردازنده های حاشیه نویسی را مشخص کنید.
- --reflection:{all,none,enum-constants,-enum-constants,name-mapping,-name-mapping}
- پشتیبانی خاص مورد نیاز برای بازتاب جاوا را ایجاد یا حذف کنید.
- --reserved-names <file>
- از تعریف مجدد شناسه های موجود در هدرهای سیستم جلوگیری می کند.
- --static-accessor-methods
- متدهای دسترسی را برای متغیرهای استاتیک و ثابت های enum ایجاد می کند.
- --strip-gwt-incompatible
- روش هایی را که با حاشیه نویسی
GwtIncompatible
علامت گذاری شده اند حذف می کند، مگر اینکه مقدار آن سازگار شناخته شود. - --strip-reflection
- ابرداده مورد نیاز برای بازتاب جاوا تولید نکنید (توجه داشته باشید: این امر پشتیبانی بازتاب را به میزان قابل توجهی کاهش می دهد).
- --swift-friendly
- کدی را ایجاد کنید که وارد کردن سوئیفت را تسهیل کند (معادل --class-properties --nullability ).
- --system
- گزینه به طور مستقیم به کامپایلر جاوا ارسال می شود (برای جزئیات به راهنمای javac مراجعه کنید).
- -t, --timing-info
- زمان چاپ صرف شده در مراحل ترجمه.
- --timing-info:{all,total,none}
- زمان چاپ صرف شده در مراحل ترجمه.
- -use-arc
- کد Objective-C را برای پشتیبانی از شمارش مرجع خودکار (ARC) ایجاد کنید.
- -use-reference-counting
- کد Objective-C را برای پشتیبانی از شمارش مرجع دستی iOS (پیشفرض) ایجاد کنید.
- -version
- اطلاعات نسخه.
- -x <زبان>
- مشخص کنید که چه زبانی را خروجی بگیرید. مقادیر ممکن عبارتند از objective-c (پیش فرض) و objective-c++ .
- -X
- راهنمای چاپ برای گزینه های غیر استاندارد.
گزینه های غیر استاندارد
- - Xbootclasspath: <path>
- مسیر بوت مورد استفاده توسط ترجمه (نه خود ابزار).
- -Xlint
- فعال کردن همه هشدارها
- -Xlint:none
- غیرفعال کردن همه هشدارهایی که توسط مشخصات زبان جاوا اجباری نشده است.
- -Xlint:- xxx
- هشدار xxx را غیرفعال کنید، که در آن xxx یکی از نامهای هشدار پشتیبانی شده برای -Xlint:xxx در زیر است.
- -Xlint:cast
- در مورد عبارات بازیگران غیر ضروری و اضافی هشدار دهید.
- -Xlint:deprecation
- در مورد استفاده از موارد منسوخ هشدار دهید.
- -Xlint:dep-ann
- در مورد مواردی که با یک نظر @deprecated مستند شده اند، اما حاشیه نویسی @Deprecated ندارند، هشدار دهید.
- -Xlint:empty
- در مورد عبارات خالی هشدار دهید.
- -Xlint:fallthrough
- بلوک های سوئیچ را برای موارد سقوط بررسی کنید و برای هر موردی که پیدا شد یک پیام هشدار ارائه دهید.
- -Xlint:finally
- در مورد آخرین finally که نمی توانند به طور عادی کامل شوند هشدار دهید.
- -Xlint:rawtypes
- در مورد عملیات بررسی نشده در انواع خام هشدار دهید.
- -Xlint:serial
- در مورد از دست دادن تعاریف serialVersionUID در کلاس های قابل سریال هشدار دهید.
- -Xlint:static
- در مورد روش های سریالی که در نمونه ها فراخوانی می شوند هشدار دهید.
- -Xlint:unchecked
- برای اخطارهای تبدیل علامت نخورده که توسط مشخصات زبان جاوا الزامی شده اند، جزئیات بیشتری ارائه دهید.
- -Xlint:varargs
- در مورد استفاده ناامن از روشهای آرگومانهای متغیر ( varargs )، بهویژه آنهایی که حاوی آرگومانهای غیرقابل تکرار هستند، هشدار دهید.
- -Xno-jsni-warnings
- اگر به جای جداکننده های OCNI از جداکننده های کد بومی JSNI (GWT) استفاده شود، هشدار دهید.