Javadoc ile Adlandırma Parametreleri

Önemli

Şu anda Xamarin platformunda özel bağlama kullanımını araştırıyoruz. Gelecekteki geliştirme çalışmalarını bilgilendirmek için lütfen bu ankete katılın.

Bu makalede, Java projesinden oluşturulan Javadoc kullanarak java bağlama projesindeki parametre adlarını kurtarma işlemi açıklanmaktadır.

Genel bakış

Mevcut bir Java kitaplığını bağlarken, ilişkili API ile ilgili bazı meta veriler kaybolur. Özellikle yöntemlere yönelik parametrelerin adları. Parametre adları , p1vb. olarak p0görünür. Bunun nedeni Java dosyalarının Java .class kaynak kodunda kullanılan parametre adlarını korumamasıdır.

Xamarin.Android Java bağlama projesi, özgün kitaplıktan Javadoc HTML'sine erişimi varsa parametre adlarını sağlayabilir.

Javadoc HTML'yi Java Bağlama Projesiyle Tümleştirme

Javadoc HTML'sini java bağlama projesiyle tümleştirmek, aşağıdaki adımlardan oluşan el ile gerçekleştirilen bir işlemdir:

1. Kitaplık için Javadoc'u indirin
2. .csproj Dosyayı düzenleyin ve bir <JavaDocPaths> özellik ekleyin:
3. Projeyi temizleme ve yeniden oluşturma

Bu yapıldıktan sonra, özgün Java parametre adları java bağlama projesine bağlı API'lerde bulunmalıdır.

Not

JavaDoc çıkışında çok fazla varyans vardır. . JAR bağlama araç zinciri her olası permütasyonu desteklemez ve sonuç olarak bazı parametreler düzgün adlandırılamayabilir.

Özet

Bu makalede, bağlı API'ler için anlamlı parametre adları sağlamak üzere Java Bağlama Projesinde Javadoc'un nasıl kullanıldığı ele alınmıştır.